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RSX-11M SUPPORTED DEVICES 


A.1 RSX-11M DEVICE SUPPORT 


RSX-11M is a disk based real-time operating system that runs on any 
UNIBUS PDP-1l processor. During system generation, the user can 
configure RSX-11M for systems ranging in size from 16K- to 
1920K-words. 


The user can generate RSX-11M as either a mapped or unmapped = system. 
A mapped system must include the KT1ll Memory Management Unit. Without 
the KT11 Memory Management Unit, RSX-11M supports between 16K- and 
28K-words of memory. With the KT11, RSX-11M supports between 24K- and 
124K-words of memory on processors other than the PDP-11/70. RSX-11M 
provides the same primary services ‘for’ -both mapped and unmapped 
systems; however, some supplied optional features and separately 
orderable options reguire hardware configurations larger than the 
minimum supported system. 


For complete and detailed information about minimum hardware required 
for the different kinds of RSX-11M distribution kits, various options, 


and combinations of peripherals, see the DIGITAL Software Product 
Description for RSX11-M, Version 3.1, Real Time Operating System and 


the RSX-l1M System Generation Manual. The RSX-11M Operator's 
Procedures Manual contains a table Of RSX-1l1M peripheral, pseudo, and 
null devices along with their respective identifiers (device-unit 
names recognized by RSX-11M). 


RSX-11M supports the following: 


A.1.1 Processors And Options 
e Any PDP-1l processor except the LSI-11 and PDP-11/03 
~ A minimum of 16K-words of memory (unmapped system) 
- Between 24K and 124K-words of memory on a system other than 
the PDP-11/70 (mapped system with the KT11 Memory Management 
Unit); and between 64K and 1920K-words on the PDP-11/70. 


- KT11 Memory Management Unit (requires a minimum of 24K-words 
of memory) 


- KE11-A,B Extended Arithmetic Element (on systems without a 
memory management unit) 


- KELI-E Extended Instruction Set 


- KELI-F Floating Instruction Set 


A.1.2 
® 


Asle3 


A.1.4 
One or 


RSX-1]11M SUPPORTED DEVICES 


- FP11l Floating Point Processor 


- KW11-Y Watch-dog Timer Clock 


Card Readers 
CRl11 card reader 


CMl1 card reader 


Communications 

DLI1-E single line interface 

DP11l synchronous line interface 
DU11 synchronous line interface 
DUP11 synchronous line interface 
DQ11 DMA synchronous line interface 
DA11-B DMA UNIBUS link 


DMC11 interprocessor link 


Data Acquisition 
more of the following subsystems: 


LPS11 Laboratory Peripheral System (requires LPS11-S, 
LPSAD-12, and LPSKW) 


AR11 Analog Real-time System 
LPA11-K Laboratory Peripheral Accelerator 


Laboratory I/O Subsystem configured using the following 
options: 


Ll. ADKI1-KT 12-bit A/D converter with 16-channel multiplexer 
and dual clock; one per subsystem) 


2. AD11-K 12-bit A/D converter with 16-channel multiplexer; 
16 per subsystem (15 if ADKI1-KT is part of same 
subsystem) 


3.° KW11-K Dual real-time clock with Schmitt triggers; 1 per 
subsystem (clock already included in ADK11-KT, not KWwll-K 
required if one is present) 


4. AM11-K 48-channel A/D multiplexer with gain ranging; one 
per AD11-K or ADK11-KT 


5. DRI1-K 16-bit digital I/O option; 16 per subsystem 


6. AAI1-K 4-channel 12-bit D/A converter with scope control, 
16 per subsystem 


RSX-11M SUPPORTED DEVICES 


A.1.5 Disk Devices 
@ RXll floppy disk system 
e RFll fixed-head disk system 
@ RKll disk cartridge controller with RKO5J or RKOSF disk drives 
@ RK61l1 disk cartridge controller with RK06 or RKO7 disk drives 
@ RPRO2 disk pack drives (with appropriate controller) 
@ RPO3 disk pack drives (with appropriate controller) 


e RPO4, RPOS, RPO6 


controller) 


or disk pack drives (with appropriate 


e RSO3 or RSO4 fixed-head disks (with appropriate controller) 
e RMO3 drives (with appropriate controller) 


@ RL11 disk cartridge controller with RLO1l disk drives 


@e RMO2 drives (with appropriate controller) 
A.1.6 Laboratory/industrial Control 

e ADO1-D A/D converter 

e AFC11 A/D converter 

® DRS/DSS11 industrial control system modules 

@e UDC11 Universal Digital Controller 

e IDA11-AA Contact sense module 

@ IDA11-AB Contact sense module 

e IDA11-BA Contact interrupt module 

e IDA11-BB Contact interrupt module 

@ IDAI11-CA I/O converter 

@ IDA1I-DA Solid state AC/DC driver 

e IDAI11-EA Flip-flop DC driver 

e IDALI1-FA Single shot driver 

e IDAL1-GA Latching output relay 

e IDALI-HA Flip-flop output relay 

e IDALI-JA Single shot output relay 

e IAALI-AA Multi-range A/D converter 

@ IAA11-BA D/A converter 

@e IAA11-BB D/A converter 
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IAA11-BC D/A converter 

IAA11-BD D/A converter 
ICS11/ICR11 Industrial Control subsystem 
IDC-IA Isolated DC sense 

IDC-IB Isolated DC interrupt 
IDC-IC I/O counter 

IDC-ID Non-isolated DC sense 
IDC-IE Non-isolated DC interrupt 
IAC-IA Isolated AC sense 

IAC-IB Isolated AC interrupt 
IDC-OA DC flip-flop driver 
IDC-OB DC single shot driver 
IAC-OA AC flip-flop driver 
IAC-OB AC single shot driver 
IRL-OA Latching output relay 
IRL-OB Flip-flop output relay 
IDA-OB 4-channel D/A converter 
IAD-IA 8-channel A/D converter 


IMX-IA 16-channel multiplexer for IAD-IA 


Printers 
LA35 line printer 
LA180 line printer 
LS11 line printer 
LP1ll line printer 


LV11 line printer (no plotter support) 


Tape Devices, Magnetic 

TA11 Dual drive cassette system 

TCll DECtape controller and dual transport 

TSO03 magnetic tape transport (with appropriate controller) 


TU10 magnetic tape transport (with appropriate controller) 
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@ TE1O magnetic tape transport (with appropriate controller) 
e TU16 magnetic tape transport (with appropriate controller) 
@ TE16 magnetic tape transport (with appropriate controller) 


e 7TU45 magnetic tape transport (with appropriate controller) 


A.1.9 Tape Devices, Paper 
e PCll paper tape reader/punch 


@e PRI1 paper tape reader 


A.1.10 Terminals 
e LA30 terminal 
@ LA36 terminal 
e LA180S terminal on the following line devices only: 


~ DH11 serial line terminal multiplexer (optional with DM11-BB 
modem control) oe? 


- DZ11 serial line terminal multiplexer 
- DJ1l serial line terminal multiplexer 
~- DL11-A,B,C,D,W single line terminal interface 
e LT33 terminal 
e LT35 terminal 
e vT05 terminal 
e VvT50 terminal 
e vT52 terminal 


e VT55 terminal 
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CODING STANDARDS AND CONVENTIONS 


B.1 CODING STANDARD INTRODUCTION 


This Appendix contains DIGITAL's PDP-1l Program Coding Standard. We 
Suggest that you use this standard for you own installation when 
writing code, such as I/O drivers, for use with the PDP-ll. 


B.1.1 Line Format 


All source lines consist of from one to a maximum of eighty characters 
(not including the audit trail added by the SLIPR (SLP in RSX-11M) 
editor). This program is described in the RSX-11M utilities manual. 


Assembly language code lines have the following format: 


1. Label field - if present, the label starts at tab stop 0 
(column 1). 


2. Operation field - the operation fiedl starts at tab stop. 1 
(column 9). 


3. Operand field - the operand field starts at tab stop 2 
(column 17). 


4. Comments field ~ the comments field starts at tab stop 4 
(column 33) and may continue to column 80. 


Include comment lines in the code body by delimiting them with a_ line 
that contains only a semicolon. The comment lines contain a leading 
semicolon with the comment itself starting in column 3. 


If the operand field extends beyond tab stop 4 (column 33), leave a 
space and start the comment. Comments that apply to an instruction 
but require continuation should always line up with the character that 
started the comment. 


B.1.2 Comments 


Comment all coding to convey the global role of an instruction, rather 
than a simple literal translation of the instruction into English. In 
general, this consists of a comment for each line of code. If a 
particularly elegant instruction sequence is used, precede that 
section of code with a paragraph of comments. 


Delimit preface text, which describes formats, algorithms, 
program-local variables, etc., by the character sequence ;+ at the 
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Start of the text and ;- at the end. These delimiters ease the 
extraction of the text by a program which could be designed for the 
purpose. The comments themselves start in column 3. 


For example: 


+- 


THE INVERT ROUTINE ACCEPTS 

A LIST OF RANDOM NUMBERS AND 
APPLIES THE KOLMOGOROV ALGORITHM 
TO THEM 


me we tO NS TO NO 


B.1.3 Naming Standards 


B.1.3.1 Register Standards - 


B.1.3.1.1 General Purpose Registers - The following mames are _ the 
only ones permitted for register names and may not be used for other 
purposes: 


RO=0 ;REG 0 

Rl=1 ;REG 1 

R2=2 ;REG 2 

R333 ;REG 3 

R4=4 ;REG 4 

R5=5 ;REG 5 

SP=6 ;STACK POINTER (REG 6) 
PC=7 ;PROGRAM COUNTER (REG 7) 


B.1.3.1.2 Hardware Registers - Name hardware registers identically to 
the hardware definition. For example, PS and SWR. 


B.1.3.1.3 Device Registers - Device registers are symbolically and 
identically named to the hardware notation. For example, the control 
status register for the RK disk is  RKCS. You may use only this 
symbolic name to refer to this register. 


B.1.3.2 Processor Priority - Use the following bits to test or alter 
processor priority: 


PRO, PRI, PR2, ceeeecalRi 


The system equates thes bits to their corresponding bit pattern. 


B.1.3.3 Other Symbols - Make frequently-used bit patterns, such as CR 
and LF, conventional symbols on an as-needed basis. 
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B.1.3.4 Using the Standard Symbols - Register standards are defined 
within the assembler. All other standard symbols appear in a file and 
are linked prior to program execution. 


B.1.4 Symbols 


B.1.4.1 Global Symbols - You can easily recognize global symbols by 
their format. The following standards apply and completely define 
symbol standards for PDP-ll Medium/Large software products. 


Figure B-1 describes the difference among global and local symbols. 


Non global L, AN AN or AN or AN or AN or AN or ' >=] 
symbol null null null null null 
Global $ or .| AN or AN or AN or AN or AN or >=] 
symbol null null null null null 
Global L $ or. AN or AN or AN or >=3 
offset null null null 
Global bit L AN $ or . AN AN or AN OL >=4 
pattern null null 
Local $ >m2 
symbol 


where: 

L is a letter 

AN is an alphanumeric character 

null is no character 

$ is a dollar sign (reserved for DEC-supplied software) 

: is a period (reserved for DEC-supplied software) 

N is a number in the range of 0 through 65535 

= means that branch targets in the form of x$, where x is a 


number, are also called labels. 


Figure B-l Difference Among Global and Local Symbols 
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B.1.4.2 Symbol Examples - Non-global Symbols 
A1B 
ZXCJ1 
INSRT 
Global Address Symbols 
$JIM 
-VECTR 
SSEC 
Global Absolute Offset Symbols 
ASJIM 
ASXT 
A.ENT 
Global Bit Pattern Symbols 
A1$20 
B3.6 
JI.M 
Local Symbols 
37$ 
2715 
6$ 


B.1.4.3 Program-Local Symbols - Self-relative address arithmetic 
(.+n) is absolutely forbidden in branch instructions. It must not be 
used in other contexts if at all possible. 


Target labels (symbols) for branches that exist only for positional 
reference use local symbols of the form: 


<num>$: 


Restrict use of global symbols to cases where reference to the symbol 
occurs external to the code. The assembler formats local symbols to 
proceed sequentially down the page and from page to page. 


B.1.4.4 Macro Names - The last two characters in a macro name _ have 
special significance. The next to last character is a $ and the last 
character specifies the mode of the macro. (The last character may 
also be a null character.) 
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For example, three macro forms exist: in-line, stack, and p-~section. 
The in-line form has no suffix (the $ is last). The stack has an S as 
the last character. The p-section has a C as the last character. 
Thus, the QUEUE I/O macro can be written in any one of the three 
following ways: 


QIo$ 
QIOSsS 
QIOSC 


The letters S$ and C are not reserved but the form of the macro is 
standard. 


B.1.5 Program Modules 


B.1.5.1 General Comments on Programs - In DEC software, a program 
provides a single distinct function. No limits exist on size, but the 
Single function limitation makes large modules a rarity. Because any 
software may exploit the memory capacity of the 11/40, 11/45, or 
11/70, programs should maintain a dense reference locus (branching 
should occur over short address distances). 


All code is read only. Code and data areas are distinct and_ each 
contains explanatory text. Read-only data should be segregated from 
read-write data. 


B.1.5.2 Module Preface - Each program module in the system exists as 
a separate file. The filename reflects the name of the module and the 
extension is of the form 'NNN'. NNN signifies the edit number or the 
version number. The version number is changed only when a new base 
level is created. Furthermore, if no corrections are made to a file 
from one base level to the next, the version number is not changed. 
The availability if File Control Services and File Control Primitives 
greatly simplify version number maintenance. Program modules adhere 
to a strict format. Reading and understanding the code is easier 
because of this format. The following sections are in each module: 


For the code section: 
1. A .TITLE statement that specifies the name of the module. If 
a module contains more than one routine, you may use 
subtitles. 


2. A .IDENT statement that specifies the version number. The 
PDP—1l1 version number standard appears in section B.10. 


3. A .PSECT statement that defines the program section in which 
the module resides. 


4. A copyright statement and the disclaimer. 
5. The version number of the file. 


The PDP-1l version number standard is described in section 
B.10. 


a 


12. 
13. 


14. 


L5. 


16. 


B.1.5.3 
1. 
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The name of the principal author and the date on which the 
module was first created. 


The name of each modifying author and the date of the 
modification. Names and modification dates appear one per 
line and in cronological order. 


A brief statement of the function of the module. 
Note: Items 1-8 should appear on the same page. 


A list of the definitions of all equated local symbols’ used 
in the module. These definitions appear one per line and in 
alphabetical order. 


All local macro definitions, preferably in alphabetical order 
by name. 


All local data. The data should indicate: 

a. Description of each element (type, size, etc.) 

b. Organization (functional, alpha, adjacent, etc.) 

c. Adjacency requirements. 

A more detailed definition of the function of the module. 


A list of the inputs expected by the module. This includes 
the calling sequence if non-standard, condition code 
settings, and global data settings. 


A list of the outputs produced as a result of entering this 
module. These include delivered results, condition code’ 
settings, but not side effects. (All these outputs are 
visible to the caller.) 


A list of all effects (including side effects) produced as a 
result of entering this module. Effects include alterations 
in the state of the system not explicitly expected in the 
calling sequence, or those not visible to the caller. 


The module code. 


Formatting the Module Preface - Rules: 


The first eight items appear on the same page and should not 
have explicit headings. Item 3 may be omitted if the blank 
P-section is being used. 


Headings start at the left margin. The left margin consists 
of a semi-colon followed by a space. Therefore, the heading 
Starts in column 3. Indent descriptive text one tab 
position. 


Items 7-14 have headings that start at the left margin and 
are preceded and followed by lines that contain only a 
leading semi-colon. Omit items that do not apply. 
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An example of a module preface follows: 


FILE-EXAMPL.SO1 


=e we NO Me TO NR TS TS NO TSH NSH NE NO ~e =e we ™S NE NSE NS NE ONO NS TO NS =e “e 6 “6 We TH “WS WS TO 


~e se 7 


=e te tO 


=e we “Se TO MH WS TE TSH NB UE =p “6 SSH tS TE 


+ 


- TITLE EXAMPLE 
- IDENT /01/ 
-PSECT KERNEL 


COPYRIGHT (C) 1978 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 

IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 


VERSION 01 

JOHN HANCOCK 1-JAN-75 
MODIFIED BY: 

QUINCY ADAMS 21-JAN-76 
JAMES MONROE 12-JUN-76 
Brief statement of the module's function. 
EQUATED SYMBOLS 

List equated symbols. 
LOCAL MACROS 

Local macros 

LOCAL DATA 

Local data 

Module function details 
INPUTS: 

Description of inputs 
OUTPUTS: 

Description of outputs 
EFFECTS: 

Descriptions of effects 


Begin module code 


CODING STANDARDS AND CONVENTIONS 


B.1.5.4 Modularity - No other characteristic has more impact on the 
ultimate engineering success of a system than does modularity. 
Modularity for PDP-11 Software Engineering's products consists of the 
application of the single-function philosophy described in section 
B.5.1 and the adherence to a set of calling and return conventions. 


B.1.5.5 Inter-Module Calling Conventions - The following calling 
conventions must be observed: 


Transfer of Control 


Macros exist for call and return. The actual transfer is by a 
JSR PC instruction. For register save routines, a JSR Rn,SAVE 
instruction is permitted. 


The CALL macro is: 
CALL subroutine-name 
The RETURN macro is: 
RETURN 
Register Conventions 


Upon entry, a subroutine minimally saves all registers it intends 
to alter except result registers. Upon exit it restores these 
registers. (State preservation is assumed across calls.) 


Argument Passing 


Any registers may be used to pass arguments, but their use should 
follow a coherent pattern. For example, if passing three 
arguments, pass them in RO, Rl, and R2 rather than RO, R2, and 
RS. Saving and restoring occurs in one place. 


B.1.5.6 Exiting - All subroutine exits occur through a single RETURN 
macro. 


B.1.5.7 Intra-Module Calling Conventions - These calling conventions 
are designer optional, but consistency favors a calling sequence 
identical to that of the inter-module sequence. 


B.1.5.8 Success or Failure Indication - The C-bit indicates success 
or failure where success equals 0 and failure equals 1. You can use 
the argument registers to return values or additional success or 
failure data. 


B.1.5.9 Module Checking Routines - Modules must verify the validity 
of arguments passed to them. The design of a module's calling 
sequence should aim at minimizing the validity checks by minimizing 
invalid combinations. You may add test code to perform additional 
checks during checkout. All code should aim at discovering an error 
as close (in terms of instruction executions) to its occurence as 
possible. 
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B.1.6 Formatting Standards 


B.1.6.1 Program Flow - Programs should be organized on the listing 
such that they flow down the page, even at the cost of an extra branch 
or jump. For example: 


PROCESS 


COMMON 


shall appear on the listing as: 


TST 
BNE BBB 
AAA: oeee aeons 
BR CMN 
BBB: een eevee 
CMN : os 0 @ oeee 


Rather than: 


TST 

BNE BBB 
AAA: wees eoeose 
CMN: eoeee eeee8e 
BBB: eee eeeee 

BR CMN 
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B.1.6.2 Common Exits - A common exit appears as the last code 
sequence on the listing, illustrated by the following flow chart: 


om ge Es 


EXIT 


should appear on the listing as: 


PRI 3 ee4ee ee92#2e 
BR EXIT 

PR2: eeee eoe#ee? 
BR EXIT 

PR3: e@eegs e@ee#es 
BR EXIT 

PR4; ese@e eeee 

EXIT: eevs eeees 


and not as: 


PRI: eee8e eeee 

EXIT: eoene eoeee 

PR2: s@ e e ee 
BR EXIT 

PR3 . eee e ee 
BR EXIT 

PR4 : eee ee ° 
BR EXIT 
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B.1.6.3 Code with Interrupts Inhibited - Code that executes 
instructions with interruptions inhibited, should be flagged by a 
comment delimiter of three semicolons. For example: 


. ERTZ: ;ENABLE BY RETURNING ] 
SYSTEM SUBROUTINES 


7 BY 
BIS PR7,PS 333 INHIBIT INTERRUPTS 
BIT PR7 ,+2 (SP) 23 C 
BEQ 10$ eg OD 
RTT aa M 
+93 M 
10$: eae tan £3} E 
ee aed atew i733 N 
eae owes 7a? T 
Site i ees 733 S 


B.1.7 Program Source Files 


Creation of and maintenance of source code is done in base levels. A 
base level is defined as a point at which changing the program source 
files is no longer allowed. From this "frozen" point to the next base 
level, corrections are not made to the base level itself; rather, a 
file of corrections is accumulated for each file in the base level. 
Whenever a updated source file is desired, the correction file is 
applied to the base file. 


The accumulation of corrections proceeds until a logical breaking 
point has occurred (for example, a milestone or significant 
implementation point is reached). At this time, all accumulated 
corrections are applied to the previous base level to create a new 
base level. Correction files are then started for the new base level. 


B.1.8 Forbidden Instruction Usage 
The following instruction usage is not allowed: 


1. The use of intructions or index words as literals of the 
previous instruction. For example, the sequence: 


MOV @PC,REGISTER 
BIC SRC,DST 


uses the bit clear instruction as a literal. This may seem 
to be a very good way to save a word but this compounds the 
problem of program maintenance. To make matters worse, this 
sequence does not execute correctly if I/D space is enabled 
on the PDP-11/45. In this case, @PC is a D bank reference. 


2. The use of the MOV instruction instead of a JMP instruction 
to transfer program control to another location. For 
example: 


MOV ALPHA,PC 


transfers control to location ALPHA. Besides taking longer 
to execute (2.3 microseconds for the MOV vs. 1.2 for the 
JMP) the use of MOV instead of JMP makes it nearly impossible 
to pick up someone else's program and tell where transfers of 
control take place. A jump trace of a program's execution is 
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impossible in this case (a move trace is unheard of). Asa 
more general issue, other operations such as ADD and SUB from 
the PC should be discouraged. Possibly one or two words can 
be saved by using these operations, but occurences where 
these operations can be used are rare. 


3. The seemingly clever use of all single word instructions 
where one double-word instruction could be used, would 
execute faster, and would not consume additional memory. 
Consider the following instruction sequence: 


CMP -(R1) ,(-R1) 
CMP -(R1) ,-(R1) 


The intent of this instruction sequence is to subtract 8 from 
register Rl (not to set condition codes). This can be 
accomplished in approximately 1/3 the time by using a SUB 
instruction (9.4 vs. 3.8 microseconds) at no additional cost 
in memory space. Also, if Rl is odd this instruction does 
not give the correct result. The SUB instruction is always 
faster and always executes correctly. 


B.1.9 Recommended Coding Practice 


B.1.9.1 Conditional Branches - When using the PDP-1l conditional 
branch instructions, the correct choice must be made between the 
signed and the unsigned branches. 


Signed Unsigned 
BGE BHIS (BCC) 
BLT BLO 

BGT BHI 

BLE BLOS (BCS) 


A common pitfall is to use a signed branch (for example, BGT) when 
comparing two memory addresses. This compare works until the two 
addresses have opposite signs; that is, one of them goes across’ the 
16K (100000(8)) boundary. This type of coding error usually occurs 
when a program is re-linked at different addresses or the program's 
size is changed. 


B.1.10 PDP-l1l1 Version Number Standard 


The PDP-1ll Version Number Standard applies to all modules, parameter 
files, complete programs, and libraries that are written as part of 
the PDP-1l Software Development effort. It provides unique 
identification of all released, pre-released, and in-house software. 


It is limited because, as currently specified, only six characters of 


identification are used, Future implementations of the Macro 
Assembler, Task Builder, and Librarian should provide for at least 
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nine characters, and possibly twelve. This standard will change as 
the need arises. The version identifier takes the following form: 


Version Identifier = <form> <version> <edit> <patch> 


<form> Identifies a particular form of a module or 
program, where applicable, as in the case of 
LINK-l1. One alphabetic character, if used, and 
null (for example, a binary 0) if not used. 


<version> Identifies the release or generation of a program. 
The version number is two decimal digits that 
Start at 00 and is incremented at the discretion 
of the project to reflect a major change. 


<edit> Identifies the level to which a particular release 
or generation of a program or module has been 
edited. An edit is an alteration to the source 
form. The edit number consists of two decimal 
digits that begin at Ol. The number is 
incremented with each edit and remains null if no 
edit occurs. 


<patch> Identifies the level to which a particular release 
or generation of a program or module has been 
patched. A patch is an alteration to a binary 
form. The patch identification consists of one 
alphabetic character that starts at B. The 
character is changed toward Z each time a set of 
patches is released and remains null if no patches 
are made. 


These fields are interrelated. When version is changed, patch and 


edit must be reset to nulls. When edit is incremented, patch is 
re-set to null because various bugs have been fixed. 


B.1.10.1 Displaying the Version Identifier - The visible output of 
the version identifier should appear as: 


Key <letter> <form> <version> - <edit> <patch> 


where the following Key letters have been identified: 


Vv released or frozen version 
X in-house experimental version 
Y field test, pre-release, or in-house release version 


and 'v' to company support. 


Use the dash that separates version from edit only if edit or patch is 
not null. When a version identifier is displayed as part of a program 
identification, the format is: 


Program 

<space><key-letter><form><version>-<edit><patch> 
Name 
Examples: 

PIP X03 


LINK VB04-C 
MACRO Y05-01 
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B.1.10.2 Use of the Version Number in the Program - All sources must 
contain the version number in an .IDENT directive. For programs (or 
libraries) that consist of more than one module, each individual 
module follows this version number standard. The version number of 
the program or library is not necessarily related to the version 
numbers of the consituent modules; it is perfectly reasonable, for 
example, that the first version of a new FORTRAN library, V00, contain 
an existing SIN routine, say V05-01. 


Parameter files are also required to contain the version number in an 
-IDENT directive. Because the assembler records the last .IDENT seen, 
parameter files must precede the program. 


Entities that consist of a collection of modules or programs (for 
example, the FORTRAN library) have an identification module in the 
first position. An identification module exists solely to provide 
identification and normally consists of something like: 


;OTS IDENTIFICATION 
-TITLE FITNLIB 
-IDENT /003010/ 

- END 


B.1.11 Co-routines 


In some cases, two program routines are highly interactive. They then 
use a special case of the JSR instruction ( JSR PC,@(SP)+ ). This 
form of the JSR instruction exchanges the top element of the stack and 
the contents of the program counter (PC). In this way, two routines 
may Swap program control and resume operation where they stopped, when 
recalled. Such routines are called co-routines. 


This swapping of control is illustrated below with an actual sequence 
of instructions from RSX-11M Executive code (Version 3.1). 


CODE ACTION STACK 
SDRECP:: 


‘ Address of caller CALLER ADR 
of SDRECP > 


CALLR $NXTSK 


(1) (JMP SNXTSK) (1) PC=Address of SNXTSK 
SNXTSK:: STACK 
SAVNR 
(1) (JSR R5,$SAVNR) (1) Push R5 contents onto 
stack (save R5). 
(2) MOV P.MAIN(RO) ,R5 Put address of next 


instruction (2) into R5 
(return address). 

Put address of SSAVNR 
into PC. 
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SSAVNR:: 

(1) MOV R4, (SP) 
(2) MOV R5, (SP) 
(3) MOV 4(SP),R5 
(4) CALL @(SP)+ 


(JSR PC,@(SP) +) 


(5) MOV (SP)+,R4 
(6) MOV (SP)+,R5 
(7) RETURN 

(RTS PC) 


SNXTSK:: 
SAVNR 


(1) MOV P.MAIN(RO) ,R5 


(2) RETURN 
(RTS PC) 


SSAVNR:: 


(5) MOV (SP)+,R4 
(6) MOV (SP)+,R5 
(7) RETURN 

(RTS PC) 


CODING 


(1) 
(2) 
(3) 


(4) 


(1) 
(2) 


(5) 
(6) 
(7) 
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Save R4 on stack 

Save R5 on stack 
Restore saved R5 from 
the stack into R5 

Pop “call to" address 
(address of step (2) in 
SNXTSK) into PC. 

Push address of next 
instruction (5) onto 
stack. 


Start SNXTSK processing 
here. 

Pop address of (5), in 
SSAVNR, into PC. 


Pop saved R4 into R4. 

Pop saved R5 into R5. 

Return to caller of 
SDRECP. 


STACK 


CALLER ADR 


STACK 


CALLER ADR 
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MACRO EXPANSIONS 


C.1 COMMAND STRING INTERPRETER MACRO EXPANSIONS 


C.1.1 CSI$1 Macro 
This macro calls the command string syntax analyzer. 


-MACRO CSIS1 CSBLK,BUFF,LEN 
-GLOBL .CSI1 

-MCALL CSI$,LDROS 

-IF NDF C.SIZE 

CSI$ 

- ENDC 

LDRO$ CSBLK 

-IF NB <BUFF> 

MOV BUFF,C.CMLD+2 (RO) 
-ENDC 

~IF NB <LEN> 

MOV LEN,C.CMLD (RO) 

- ENDC 

JSR PC,.CSI1 

-ENDM 


C.1.2 CSI$2 Macro 
This macro calls the command string semantic parser. 


»-MACRO CSI$2 CSBLK,IO,SWTAB 
-GLOBL .CSI2 

-MCALL CSIS$,LDRO$ 

~-IF NDF C.SIZE 

CSI$ 

»ENDC 

LDRO$ CSBLK 

~IF NB <IQ> 

~IF IDN <INPUT>,<I0O> 

MOVB #CS.INP, (RO) 

LFF 

-IF IDN <OUTPUT>,<IO> 

MOVB #CS.OUT, (RO) 

LFF 

» ERROR sIncorrect request to .CSI2 
» ENDC 

~ ENDC 

» ENDC 


C=] 
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-IF NB <SWTAB> 

MOV SWTAB,C.SWAD (RO) 
eENDC 

JSR PC,.CSI2 

-ENDM 


C.1.3 CSISSW Macro 
This macro defines the switch table entry. 


»MACRO CSISSW SW,MK,MKW,CLR,NEGS,VALTAB,LNG 


IF B,SW 

- ERROR :;Missing switch name 
~IFF 

~ EVEN ;Force to word alignment 


-NCHR SI2$$,SW 
-IF GT,SIZ$$-2 
.IF B,LNG 
SIZS$=2 

~ENDC 

~ENDC 

CNTS$=0 

-IRPC CHRSSS,SW 
CHRSS=''CHRSSS 
CNTSS=CNTSS+1 


-IF LE,<CHRS$-<'Z+°040>> 


CHRSS=CHRS$-*040 
-ENDC 

-ENDC 

-IF LE,CNTSS-SIZS$ 
$,=0 

-IF NB,LNG 

-IF IDN,<LNG>,<EXACT> 
-IF GT,CNTSS$&1l 

-IF GE,CNTSS$+1-S12$$ 
$$="0200 

.ENDC 

.IFF 

-IF LT,CNTS$-S12$S 
$$="0200 


.-ENDC 
.ENDC 

-IFF 

IF IDN,<LNG> ,<LONG> 
-IF EQ,CNTSS$é&1 

.IF LT,CNTS$-S1Z$S$ 
$$="020 


»ENDC 
» ENDC 
~IFF 
«ERROR 


» ENDC 
-» ENDC 
- ENDC 
» BYTE 
-ENDC 
«ENDM 
- EVEN 


CHRSS!S$ 


;Set SIZ$$ to no. of chars in sw 
;If string is longer than 2 chars 
sand not "long" or “exact” 

trim it back to 2 characters 


For each character in SW 


+If .GE. lower case A 
> and .LE. lower case 2 
; convert to upper case alpha 


:;I£ more characters to store 


7I1£ "long" or “exact” 

;If “exact" 

and if first byte of word 

and if last word in switch name 
then set the exact match flag 


=e =e 8 


If 2nd byte of word 

and if not the last character 
set the "more ASCII words 
coming" bit 


=e "SS se Oe 


;End of “if first byte of word" 
7;If not "exact" 

;Must be "long", otherwise error 
;If 2nd byte of word 

; and not the last character 

; set the "more ASCII words 

7 coming" bit 


;If not "long" 

;Illegal "long" or "exact" 

3; specifier 

;End of if "long" 

sEnd of if "exact" 

;End of IF NB,LNG 

;Generate a character 

s;End of "if more characters" 
;End of the IRPC loop 

;Round up to next word boundary 
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- ENDC ;End of .IF B,SW 
-IF NB MK 

»WORD MK 

-IFF 

-WORD 0 

~ENDC 


LF NB CLR 

~IF IDN <CLEAR> ,<CLR> 
$$=1 

eIFF 

IF IDN <SET>,<CLR> 

LFF 

» ERROR sInvalid set/clear spec 

»ENDC 

» ENDC 

« ENDC 

-WORD MKW+S$ 
$$=0 

LF NB NEGS 

~-IF IDN <NEG>,<NEGS> 


LFF 

»ERROR s;Invalid negate spec 
» ENDC j 

»ENDC 

«WORD VALTAB+SS$ 

~ENDM 


C.1.4 CSISND Macro 
This macro defines the end of the switch value table end. 


-MACRO CSISND 
-WORD 0 
-ENDM 


C.1.5 CSI$SV Macro 
This macro defines the switch value table entry. 


»MACRO CSISSV TYPE,ADDR,LEN,VALTAB 
~IF NB VALTAB 
VALTAB: 
-ENDC 
IF NB TYPE 
~-IF IDN <ASCII>,<TYPE> 
~BYTE 1 
~IFF 
-IF IDN <NUMERIC>,<TYPE> 
~BYTE 2 
~LlFF 
-IF IDN <OCTAL> ,<TYPE> 
~-BYTE 2 
~IFF 
IF IDN <DECIMAL> ,<TYPE> 
~-BYTE 3 
-IFF 
» ERROR sInvalid conversion type 
-ENDC 
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- ENDC 
-ENDC 
-ENDC 

~IFF 

-BYTE 1 
~ENDC 

-IF NB LEN 
-BYTE LEN 
-IFF 

- ERROR 
-BYTE 0 
-ENDC 

-IF NB ADDR 
»WORD ADDR 
LFF 

- ERROR 
~WORD 0 

- ENDC 
-ENDM 


C.1.6 LDROS Macro 


sASCII conversion assumed 


;Length missing 


;Value address missing 


This macro conditionally loads RO. 


.MACRO LDROS ARG 

-IIF B,ARG,.MEXIT 
-NTYPE PARSSS ,ARG 
-IIF EQ,PARSS$,.MEXIT 
MOV ARG,RO 

.ENDM 


C.1.7 CSI$ Macro 


This macro defines command string interpreter symbols. 


.MACRO CSI$ GBL 
“IF IDN <GBL>,<DEFS$G> 


-GLOBL C.TYPR,C.STAT,C.CMLD,C.DEVD,C.DIRD,C.FILD,C.SWAD 


~-GLOBL C.MKW1,C.MKW2 


-GLOBL C.SIZE,C.DSDS,CS.INP,CS.OUT 
-GLOBL CS.NMF,CS.DIF,CS.DVF,CS.WLD,CS.MOR,CS .EQU 


»ENDC 
C.TYPR=0 
C.STAT=1 
C.CMLD=2 


C.DEVD=6 


C.DIRD="0<12> 


C.FILD="0<16> 


C.SWAD="0<22> 
C.MKW1="0<24> 


;Request type (for CSI2) 

;Status (from CSI2) 

Length of command string buffer 
;Address of command string buffer 
;Length of device name string 
;Address of most recent device 

; name string 

;Length of most recent DIR info 
;Address of DIR info 

;Length appropriate to C.FILD+2 
3;CSI1 - address of string seg 

; where error occurred 

7;CSI2 - address of file name for 
7 Current request 

sAddress of current switch table 
:OR of masks for all switches 

; found this call 


C.MKW2="0<26> 
C.SIZE="0<54> 
C.DSDS=C.DEVD 


7C.TYPR VALUES 
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;On/foff settings of masks for 

3; switches found 

;Size of CSI control block (in 

; bytes) 

;Displacement to 6 word block for 
; FCS 


CS.INP=1 *Request input string 

CS .OUT=2 ;Request output string 

7;C.STAT VALUES 

CS .NMF=1 ;1 = File name specified this seg 
; Of string 

CS .DIF=2 3:1 = Dir info specified this seg 
; of string 

CS .DVF=4 31 = Device name specified this 
; seg of string 

CS.WLD="0<10> ;File name has wild card switch 

CS.MOR="0<20> ;More string segs follow 

CS.EQU="0<40> ;Equal sign seen by CSI1 


C.2 DIRECTIVE MACRO EXPANSIONS 


-MACRO CALL ADR 
JSR PC,ADR 
»~ENDM CALL 
-MACRO RETURN 
RTS PC 

-ENDM RETURN 


-MACRO CALLR ADR 
JMP ADR 
-ENDM CALLR 


C.2.1 ABRTSC Macro 


ABRTSC generates a DPB for the ABORT TASK directive in a _ separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: ABRTSC TSK,PSCT,ERR 


Description: ABRTSC generates a DPB for the ABORT TASK directive in 
the separate SDPBS$ program section and generates an EMT 377 in the 
program section specified by PSCT. TSK, the task name, is the only 
argument required for the DPB definition. The optional argument, ERR, 
must be a valid assembler destination operand specifying an error 
routine address. Because this routine invokes ABRT$, the same factors 
govern the expansion of code and symbolic offsets. 


»MACRO ABRTSC TSK,PSCT,ERR 

-MCALL ABRTS ,DIRS 

-IF NDF $S$SGLB 

-PSECT SDPBSS 
$$$=, 

~IFTF 

ABRTS TSK 

~IFT 

~.PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

-ENDM ABRTSC 
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C.2.2 ABRTSS Macro 


ABRTSS pushes a DPB for the ABORT TASK directive on the stack and 
generates an EMT 377. 


Macro call: ABRTSS NAMADR,ERR 


Description: ABRTSS pushes a DPB for the ABORT TASK directive on the 
stack. The argument, NAMADR, must be a valid assembler operand that 
yields the address of a double-word with the task name in RADIX-50. 
ABRTSS then generates an EMT 377 and considers the optional argument, 
ERR, the error routine address. 


-MACRO ABRTSS NADR,ERR 
-MCALL RFAS ,DIRS 

RFAS NADR 

MOV (PC) +,-(SP) 

-BYTE 83.,3 

DIRS ,ERR 

-ENDM ABRTSS 


C.2.3 ABRTS Macro 


The ABRTS macro generates a DPB for the ABORT TASK directive. 


Macro call: ABRTS TSK 


Description: This macro creates a DPB for the ABORT TASK directive. 
The argument, TSK, is the name of the task to be aborted. 


This macro defines the following symbolic offset: 
A.BTTN-(length is 4 bytes) Task name. 


The ABRT$ macro generates the A.BTTN symbolic offset only when the 
S$S$GLB is defined. The symbol, A.BTTIN, is a global symbol in this 


case, 


-MACRO ABRTS TSK 
-MCALL R50$ ,OFFS 
-IF NDF SSSGLB 
-BYTE 83.,3 

R50$ TSK 

~ENDC 

-IF NDF A.BTTN 
-NLIST 

OFFS 

OFFS A.BTTN,4 
-LIST 

~ENDC 

.ENDM ABRT$S 


C.2.4 ALTPSC Macro 


The ALTPSC macro generates a DPB for the ALTER TASK PRIORITY directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: ALTPSC TTASK,NPRIO,PSCT,ERR 
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Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive in the programsection named SDPB$$. The DPB parameters are 
described in the ALTPS macro. Then the macro generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address. The ALTPS macro controls symbolic offset 
generation. 


.MACRO ALTPSC TTASK,NPRIO,PSCT,ERR 
.MCALL ALTPS , DIRS 
.IF NDF SSSGLB 
-PSECT $DPBS$ 
~IFTF 

ALTPS TTASK,NPRIO 
IFT 

»PSECT PSCT 

DIRS #$S8$,ERR 
.ENDC 

.ENDM ALTPSC 


C.2.5 ALTPSS Macro 


The ALTP$S macro generates the code to push a DPB for the ALTER TASK 
PRIORITY directive on the stack followed by EMT 377. 


Macro call: ALTP$S NAMADR,NPRIO,ERR 


Description: This macro generates the code to push a DPB for ALTER 
TASK PRIORITY on the stack. The argument, TNAMADR, must be a valid 
assembler source operand that yields the address of a double-word 
containing the RADIX-50 name specified in the ALTP$ macro. The macro 
then generates an EMT 377. The DIR$ macro describes the ERR error 
service address. 


«MACRO ALTPSS NAME,PRI,ERR 
-MCALL MOVS ,RFAS ,DIR$ 

MOV$ PRI 

RFAS NAME 

MOV (PC)+,-(SP) 

-BYTE 9.,4 

DIR$ ,ERR 

-ENDM ALTPSS 


C.2.6 ALTP$ Macro 
The ALTPS macro generates a DPB for the ALTER TASK PRIORITY directive. 
Macro call: ALTPS TTASK,NPRIO 


Description: This macro generates a DPB for the ALTER TASK PRIORITY 
directive. The arguments are assumed to have the following meanings: 


TTASK=Name of target task for new priority 
NPRIO=New priority for task 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


A.LTTN-(length 4 bytes) target task name, 
T.LTPR-(length 2 bytes) new priority 
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If the macro is invoked with the $$S$GLB symbol defined, the ALTPS 
macro does not generate the DPB and ALTPS defines the offsets as 
global symbols. 


-MACRO ALTPS NAME,PRI 
-MCALL R50S,OFFS 
-IF NDF S$SGLB 
-BYTE 9.,4 

R50$ NAME 

-WORD PRI 

.ENDC 

.IF NDF A.LTIN 
-NLIST 

OFFS 

OFFS A.LTIN,4 
OFFS A.LTPR,2 
~LIST 

~ENDC 

.ENDM ALTPS 


C.2.7 ALUNSC Macro 


The ALUNSC macro generates a DPB for the ASSIGN LUN directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro Call: ALUNSC LUN,DEVNAM,DEVNUM,PSCT,ERR 


Description: This macro generates a DPB for the ASSIGN LUN directive 
in the program section named $DPBS$. The arguments through DEVNUM are 
the DPB parameters as described for the ALUNS macro. The macro then 
generates an EMT 377 in the program section as specified by PSCT. The 
argument, ERR is as described for the DIRS macro. For an explanation 
of symbolic offsets, see the ALUNS macro. 


.MACRO ALUNSC LUN,DA,DU,CS,ERR 
-MCALL ALUNS ,DIRS 

-IF NDF $$SGLB 

»-PSECT SDPBSS$ 


$$$=. 
.IFTP 
ALUNS LUN,DA,DU 
<IFT 
-PSECT CS 
DIRS #5$$,ERR 
-ENDC 


-ENDM ALUNSC 


C.2.8 ALUNSS Macro 


The ALUNSS macro generates the code to push a DPB for the ASSIGN LUN 
directive on the stack followed by an EMT 377. 


Macro call: ALUNSS LUN,DEVNAM,DEVNUM,ERR 


Description: This macro generates the code to push a DPB for. the 
ASSIGN LUN directive on the stack. The arguments through DEVNUM must 
be valid assembler source operands, and they must specify the DPB 
parameters listed in the ALUNS macro. The DIRS macro describes the 
ERR argument. 
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»-MACRO ALUNSS LUN,DA,DU,ERR 
-MCALL MOVS ,DIRS 

MOVS DU 

MOVS DA 

MOVS LUN 

MOV (PC)+,-(SP) 

,BYTE. 7,4 

DIRS ,ERR 

-ENDM ALUNSS 


C.2.9 ALUNS Macro 
The ALUNS macro generates a DPB for the ASSIGN LUN directive. 
Macro call: ALUNS LUN,DEVNAM,DEVNUM 


Description: This macro creates a DPB for the ASSIGN LUN directive. 
‘The arguments are assumed to have the following meanings: 


LUN=Logical unit number, 
DEVNAM=Physical device name (two characters), 
DEVNUM=Physical device unit number. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: : . 


A.LULU-(length 2 bytes) Logical unit number, 
A.LUNA-(2) Physical device name, 
A.LUNU-(2) Physical device unit number. 


If the macro is invoked with the symbol, $SSGLB, defined, ALUNS does 
not generate the DPB and ALUNS defines the offsets as global symbols. 


»-MACRO ALUNS LUN,DA,DU 
-MCALL OFFS 

-IF NDF $$$GLB 

-BYTE 7,4 

-WORD LUN 

.IF B <DA> 

~WORD 0 

-IFF 

»-NCHR $$S$T1,<DA> 


$$$sT2=. 

-ASCII /DA/ 
-=$S$ST2+2 

-ENDC 

»WORD DU 

-ENDC 

-IF NDF A.LULU 

.NLIST 

.IRP X,<,<A.LULU,2>,<A.LUNA,2>,<A.LUNU,2>> 

OFFS X 

-ENDM 

.LIST 

-ENDC 

-ENDM ALUNS 
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C.2.10 ASTX$C Macro 


The ASTXSC macro generates a DPB for the AST SERVICE EXIT directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: ASTXSC PSCT,ERR 


Description: This macro generates a DPB for the AST SERVICE EXIT 
directive in the program section named SDPB$$. The argument, PSCT, is 
the program section in which to generate an EMT 377. The DIRS macro 
describes the ERR argument. 


»MACRO ASTX$C PSCT,ERR 

»MCALL ASTXS ,DIRS 

-IF NDF $S$SGLB 

-PSECT SDPBS$ 
$$$=2. 

~IFTF 

ASTXS 

~IFT 

~PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

»ENDM ASTXSC 


C.2.11 ASTX$S Macro 


The ASTXSS macro generates the code to push a DPB for the AST SERVICE 
EXIT directive on the stack followed by an EMT 377. 


Macro call: ASTXSS ERR 


Description: This macro generates the code to push a DPB for the AST 
SERVICE EXIT directive on the = stack. Then a MONITOR TRAP is 
generated. The error routine address argument, ERR, results in an an 
unconditional call following the EMT because control should never be 
returned on the AST exit. 


ACRO ASTX$S ERR 
-MCALL DIR$ 
MOV (PC)+,-(SP) 
~BYTE 115.,1 
DIRS 
.IIF NB <ERR>, JSR PC,ERR 
-ENDM ASTXSS 


C.2.12 ASTX$ Macro 
The ASTX$ macro generates a DPB for the AST SERVICE EXIT directive. 
Macro Call: ASTXS$ 


Description: This macro creates a DPB for the AST SERVICE EXIT 
directive. It takes no arguments. 
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Note: If the symbol, $S$GLB, is defined, this macro does not generate 
any code. 


~MACRO ASTXS 
-IF NDF SSSGLB 
-BYTE 115.,1 
.ENDC 
-ENDM ASTXS 


C.2.13 CINTSC Macro 


The CINTSC macro generates a DPB in a separate PSECT for the CONNECT 
TO INTERRUPT VECTOR directive followed by an EMT 377 in the user 
specified PSECT. 


Macro call: CINTSC VEC,BASE,ISR,DSI,PSW,AST,PSCT,ERR 


Description: CINTSC generates a DPB in the program section named 
SDPBS$ for the CONNECT TO INTERRUPT VECTOR directive. CINTS describes 
the the DPB parameters. CINT$C then generates an EMT 377 in the 
program section named in PSCT. The DIR§$ macro describes the ERR error 
service address. 


.MACRO CINTSC VEC,BASE,ISR,DSI,PSW,AST,PSCT,ERR 
.MCALL CINTS ,DIRS 
-IF NDF $$SGLB 
»-PSECT SDPBSS 
$$$=. 
-IFTF 
CINTS VEC,BASE,ISR,DSI,PSW,AST 
IFT 
-PSECT PSCT 
DIRS #$$$,ERR 
.ENDC 
-ENDM CINTSC 


C.2.14 CINT$S Macro 


The CINTSS macro generates the code to push a DPB on the stack for the 
CONNECT TO INTERRUPT VECTOR directive followed by an EMT 377. 


Macro call: CINT$S VEC,BASE,ISR,DSI,PSW,AST,ERR 


Description: CINTSS generates the code to push a DPB for the CONNECT 
TO INTERRUPT VECTOR directive on the stack. The DPB arguments must be 
valid assembler source operands and then must specify the information 
described in the CINTS macro. The macro, RVP$, pushes the arguments 
on the stack in reverse order. CINTSS also generates an EMT 377 and 
uses the ERR error service address as described in the DIR$ macro. 


»MACRO CINTS$SS VEC,BASE,ISR,DSI,PSW,AST,ERR 
-MCALL RVP$,DIRS§ 

RVPS VEC,BASE,ISR,DSI,PSW,AST 

MOV (PC)+,-(SP) 

-BYTE 129.,7 

DIRS ,ERR 

-ENDM CINTSS 


Cit 
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C.2.15 CINTS Macro 
‘CINTS generates a DPB for the CONNECT TO INTERRUPT VECTOR directive. 
Macro call: CINTS VEC,BASE,ISR,DSI,PSW,AST 


Description: CINTS generates a DPB for the CONNECT TO INTERRUPT 
VECTOR directive. The arguments are assumed to have the following 
meanings: 


VEC = Must be in the range 60(8) through the highest vector 
specified during SYSGEN, and must be a multiple of 4. 


BASE = Virtual base address for kernel APR 5 mapping of the ISR, 
and enable/disable interrupt routines -- This address is 
automatically truncated to a 32(10)-word boundary. The 
"base" argument is ignored in an unmapped system. 


ISR = Virtual address of the ISR, or 0 to disconnect from the 
interrupt vector. 


DSI = Virtual address of the enable/disable interrupt routine. 
PSW = Initial priority at which the ISR is to execute -- 
This is normally egual to the hard-wired interrupt 
priority, and is expressed in the form n*40, where n is a 
number in the range 0-7. This form puts the value in bits 
5-7 of pri. It is recommended that the programmer make 
use of the symbols PR4, PR5, PRO, and PR? for this 
purpose. These are implemented via the macro HWDDF$ found 
in [1,1]EXEMC.MLB. AST = Virtual address of an AST 
routine to be entered after the fork level routine queues 
an AST. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


C.INVE -- Vector address (2) 


C.INBA -- Base address (2) 

C.INIS -- ISR address (2) 

C.INDI -- Enable/disable interrupt routine address (2) 
C.INPS -- Priority (2) 


C.INAS -- AST address (2) 


If the macro is invoked with the $SSGLB symbol defined, the CINTS 
Macro does not generate the DPB and CINTS defines the offsets as 
global symbols. 


-MACRO CINTS VEC,BASE,ISR,DSI,PSW,AST 
-MCALL OFFS 
-IF NDF $SSGLB 
-BYTE 129.,7 
-WORD VEC 
-WORD BASE 
.WORD ISR 
-WORD DSI 
.WORD PSW 
-WORD AST 
.ENDC 

.IF NDF C.INVE 
OFFS 

OFFS C.INVE,2 
OFFS C.INBA,2 
OFFS C.INIS,2 
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OFF$ C.INDI,2 
OFFS C.INPS,2 
OFFS C.INAS,2 
.ENDC 

-ENDM CINTS 


C.2.16 CLEFSC Macro 


The CLEFSC macro generates a DPB for the CLEAR EVENT FLAG directive in 
a separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: CLEFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive in the S$DPBS$ program section. The CLEF$ macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The CLEFS macro controls symbolic address 
generation. 


.MACRO CLEFSC EFN,CS,ERR 
.MCALL CLEFS ,DIR$ 

.IF NDF $SSGLB. 

»-PSECT S$DPBS$ 


$$$=. 
~IFTF 
CLEFS EFN 
IFT 
.PSECT CS 
DIRS #$$5$,ERR 
~ENDC 


~ENDM CLEFSC 


C.2.17 CLEFS$S Macro 


The CLEFSS macro generates the code to push a DPB for the CLEAR EVENT 
FLAG directive on the stack followe by an EMT 377. 


Macro call: CLEFSS EFN,ERR 


Description: This macro generates the code to push a DPB for the 
CLEAR EVENT FLAG directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the CLEFS macro. This macro also generates a monitor 
trap, using the error service address, ERR, as described in the DIRS 
macro. 


MACRO CLEFSS EFN,ERR 
~-MCALL MOVS ,DIR$ 

MOVS EFN 

MOV (PC) +,-(SP) 

BYTE 31.,2 

DIR$ ,ERR 

.ENDM CLEFSS 
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C.2.18 CLEF$ Macro 
The CLEF$ macro generates a DPB for the CLEAR EVENT FLAG directive. 
Macro call: CLEFS EFN 


Description: This macro generates a DPB for the CLEAR EVENT FLAG 
directive. The argument is assumed to have the following meaning: 


EFN=EVENT FLAG NUMBER. 


The following symbol is lecally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


C.LEEF-(length 2 bytes) Event flag number. 


If the macro is invoked with the symbol, S$SSGLB, defined, CLEFS$ does 
not generate the DPB and CLEFS defines the offset as a global symbol. 


-MACRO CLEFS EFN 
~MCALL OFFS 
-IF NDF $SSGLB 
-BYTE 31.,2 
.WORD EFN 
.ENDC 

-IF NDF C.LEEF 
.NLIST 

OFFS 

OFFS C.LEEF,2 
-LIST 

.ENDC 

-ENDM CLEFS 


C.2.19 CMKTSC Macro 


The CMKTSC macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro Call: CMKTSC EFN,AST,PSCT,ERR 


Description: This macro generates a DPB for the CANCEL MARK-TIME 
REQUESTS directive in the $DPBS$$ program section. The CMKTSS macro 
describes the DPB parameters. Then the macro generates an EMT 377 in 
the program section named in the PSCT argument. The DIRS macro 
describes the ERR error service address. 


-MACRO CMKTSC EFN,AST,PSCT,ERR 

-MCALL CMKTS ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBSS$ 
$$S$=, 

~IFTF 

CMKTS EFN,AST 

IFT 

.PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

-ENDM CMKTSC 
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C.2.20 CMKTSS Macro 


The CMKTS$S macro generates the code to push a DPB for the CANCEL 
MARK-TIME REQUESTS directive on the stack followed by an EMT 377. 


Macro call: CMKTSS EFN,AST,ERR 


Description: This macro generates the code to push a DPB for the 
CANCEL MARK-TIME REQUESTS directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the CMKT$ macro. The macro also generates an 
EMT 377. The DIRS macro describes the ERR error service address. 


Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, the CMKT$S macro ignores them. 


»MACRO CMKTSS EFN,AST,ERR 
»MCALL DIRS 

MOV (PC)+,-—(SP) 

-BYTE 27.,1 

DIRS ,ERR 

~-ENDM CMKTSS 


C.2.21 CMKTS Macro 


The CMKT$ macro generates a DPB for the CANCEL MARK-TIME REQUESTS 
directive. 


Macro call: CMKTS$ EFN,AST 


Description: This macro generates a DPB for the CANCEL MARK~TIME 
REQUESTS directive. 


Note: The EFN and AST arguments are required to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, the CMKT$ macro ignores them. If the $SSGLB symbol is 
defined, this macro does not generate any code. 


»-MACRO CMKTS EFN,AST 
.IF NDF $SSGLB 

~BYTE 27.,1 

.ENDC 

~ENDM CMKTS 


C.2.22 CSROQSC Macro 


The CSRQ$C macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: CSRQSC TTASK,RTASK,PSCT,ERR 


Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive in the $DPB$$ program section. The DPB parameters 
are described in the CSRQ$ macro. Then the macro generates an EMT 377 
in the original program section named in PSCT. The DIRS macro 
describes the ERR error service address. The CSRQ$ macro controls 
symbolic address generation. 


MACRO EXPANSIONS 


Note: Read the discussion notice concerning ignored arguments in the 
CSRQ$ macro below. 


-MACRO CSROQSC TT,RT,CS,ERR 
-MCALL CSRQS,DIRS 

-IF NDF SSSGLB 

-PSECT SDPBSS$ 


$$$=, 
~IFTF 
CSROS TT,RT 
-IFT 
-PSECT CS 
DIRS #$$$,ERR 
~ENDC 


-ENDM CSRQ$C 


C.2.23 CSRQSS Macro 


The CSRQ$S macro generates the code to push a DPB for the CANCEL 
SCHEDULED REQUESTS directive on the stack followed by an EMT 377. 


Macro call: CSRQSS TNAMADR,RNAMADR,ERR 


Description: This macro generates the code to push a DPB for CANCEL 
SCHEDULED REQUESTS on the stack. The TNAMADR and RNAMADR arguments 
must be valid assembler source operands that yield the addresses of 
double-words containing the RADIX-50 names’ specified in the CSRQ$ 
Macro. The macro then generates an EMT 377. The DIRS macro describes 
the ERR error service address. 


Note: Read the discussion notice concerning ignored arguments in the 
CSRQS$ macro below. 


~-MACRO CSRQ$S TN,RN,ERR 
-MCALL RFAS ,DIRS$ 

RFAS TN 

MOV (PC) +,-(SP) 

sBYTE 2543 

DIRS ,ERR 

-ENDM CSRQSS 


C.2.24 CSRQ$ Macro 


The CSRQ$ macro generates a DPB for the CANCEL SCHEDULED REQUESTS 
directive. 


Macro call: CSRQS TTASK,RTASK 


Description: This macro generates a DPB for the CANCEL SCHEDULED 
REQUESTS directive. The arguments are assumed to have the following 
meanings: 


TTASK=Scheduled (target) task name, 
RTASK=Scheduler (requester) task name. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 

C.SRTN-(length 4 bytes) target task name, 

C.SRRN-(4) requester task name. 
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If the macro is invoked with the $$$GLB symbol defined, CSRQ$ does not 
generate the DPB and it globally defines the symbolic offsets. 


Note: The RTASK argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the CSRQ$ macro 
ignores it. 


.MACRO CSROQOS TT,RT 
»MCALL R50$ ,OFFS 
~IF NDF $SSGLB 
-BYTE 25.,3 

R50$ TT 

~ENDC 

.IF NDF C.SRIN 
-NLIST 

OFFS 

OFFS C.SRIN,4 
OFFS C.SRRN,4 
.LIST 

»ENDC 

»ENDM CSRQS$ 


C.2.25 DECLS$C Macro 


The DECL$C macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program section. 


Macro call: DECLSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive in the S$DPB$$ program section. This macro also 
generates an EMT 377 in the user specified program section, PSCT, with 
the ERR error service address as described in the DIRS macro. 


Note: The EFN argument is required to maintain compatibility with 
RSX-11D. Despite the fact that it must be specified, the DECLSC macro 
ignores it. 


»MACRO DECLSC EFN,PSCT,ERR 
»MCALL DECLS$ ,DIRS$ 
~IF NDF $$S$GLB 
»PSECT SDPBSS 

$$$=. 
.IFTF 
DECLS EFN 
~IFT 
.PSECT PSCT 
DIRS #$$$,ERR 
~ENDC 
.ENDM DECLS$C 


C.2.26 DECLS$S Macro 


The DECL$S macro generates the code to push a DPB for the DECLARE 
SIGNIFICANT EVENT directive on the stack followed by an EMT Btls 


Macro call: DECLSS EFN,ERR 
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Description: This macro generates the code to push a DPB for the 
DECLARE SIGNIFICANT EVENT directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the DECL$ macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIRS macro. 


Note: The EFN argument is required to maintain compatibility with 
RSX-11D. Despite the fact: that it must be specified, the DECLS macro 
ignores it. 


-MACRO DECLSS EFN,ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 

-BYTE 35.,1 

DIRS ,ERR 

»ENDM DECLSS 


C.2.27 DECLS Macro 


The DECL$ macro generates a DPB for the DECLARE SIGNIFICANT EVENT 
directive. 


Macro call: DECLS EFN 


Description: This macro generates a DPB for the DECLARE SIGNIFICANT 
EVENT directive. DECL$ ignores the EFN argument but EFN must be 
present to maintain compatibility with RSX-11D. 


»-MACRO DECLS EFN 
-IF NDF SSSGLB 
-BYTE 35.,1 
.~ENDC 

-ENDM DECLS 


C.2.28 DIRS$ Macro 


DIRS generates an RSX-11M directive call (EMT 377) with a pre-defined 
DPB. 


Macro call: DIRS ADR,ERR 


Description: The argument, ADR, must be a valid assembler source 
Operand. It pushes the DPB address on the stack. DIRS then generates 
an EMT 377 to trap to the Executive. The argument, ERR, is optional. 
If ERR is defined, it must be a valid assembler destination operand to 
permit the execution of a JUMP TO SUBROUTINE instruction to an error 
handler if the directive CALL fails. 


»MACRO DIRS ADR,ERR 

-IF NB <ADR> 

MOV ADR,-(SP) 

-ENDC 

EMT “0O<377> 

-IIF NB <ERR>, .MCALL ERRS 
-IIF NB <ERR>, ERRS ERR 
-ENDM DIRS 
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C.2.29 DSARSC Macro 


The DSAR$C macro generates the DPB for the DISABLE AST RECOGNITION 
directive in a separate program section followed by an EMT 377 in the 
user specified PSECT. 


Macro call: DSARSC PSCT,ERR 


Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive in the PSECT SDPB$$ followed by an EMT 377 in 
the program section specified in PSCT. The DIRS macro describes the 
ERR error service address. 


»MACRO DSARSC PSCT,ERR 

.MCALL DSARS ,DIR$ 

.IF NDF $$SGLB 

.PSECT S$DPBS$ 
$$$=,. 

~IFTF 

DSARS 

IFT 

.PSECT PSCT 

DIRS #$$$,ERR 

»ENDC 

.ENDM DSARSC 


C.2.30 DSARSS Macro 


The DSAR$S macro generates the code to push a DPB for the DISABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 


Macro call: DSARSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377, using the ERR error service address, described 
in the DIRS macro. 


.MACRO DSARSS ERR 
.MCALL DIRS 

MOV (PC) +,-—(SP) 
-BYTE 99.,1 

DIRS ,ERR 

-ENDM DSARSS 


C.2.31 DSARS$ Macro 


The DSARS macro generates a DPB for the DISABLE AST RECOGNITION 
directive. 


Macro call: DSARS$ 


Description: This macro generates a DPB for the DISABLE AST 
RECOGNITION directive. 


»~MACRO DSARS 
-IF NDF $S$S$GLB 
-BYTE 99.,1 
.ENDC 

»~ENDM DSARS 
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C.2.32 DSCPSC Macro 


The DSCPSC macro generates a DPB for the DISABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: DSCPSC PSCT,ERR 


Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive in the SDPBS$ program section and an EMT 377 in the user 
specified PSCT program section. The DIR$ macro describes the ERR 
error service address. 


-MACRO DSCPSC PSCT,ERR 

-MCALL DSCPS ,DIRS 

-IF NDF $S$SGLB 

-PSECT S$DPB$$ 
$$$=, 

.IFTF 

DSCPS 

IFT 

»PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

-ENDM DSCPSC 


C.2.33 DSCPS$SS Macro 


The DSCP$S macro generates the code to push a DPB for the DISABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 


Macro call: DSCPS$S ERR 


Description: This macro generates the code to push a one-word DPB for 
the DISABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 
generated, using the ERR error service address, as described in the 
DIRS macro. 


-MACRO DSCPSS ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
~BYTE 95.,1 

DIR$ ,ERR 

»ENDM DSCPSS 


C.2.34 DSCPS$ Macro 


The DSCPS macro generates a DPB for the DISABLE CHECKPOINTING 
directive. 


Macro call: DSCPS$ 


Description: This macro generates a DPB for the DISABLE CHECKPOINTING 
directive. There are no arguments. 


«MACRO DSCPS$ 
-IF NDF $SSSGLB 
»BYTE 95.,1 

» ENDC 

-ENDM DSCPS$ 
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C.2.35 ENARSC Macro 


The ENARSC macro generates a DPB for the ENABLE AST RECOGNITION 
directive in a separate PSECT, followed by an EMT 377 in the user 
specified PSECT. 


Macro call: ENARSC PSCT,ERR 


Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive in the S$DPB$$ program section followed by an EMT 
377 in the program section named in PSCT. The DIRS macro describes 
the ERR error service address. 


.MACRO ENARSC PSCT,ERR 

.MCALL ENARS ,DIRS 

~IF NDF $$S$GLB 

-PSECT $DPBS$$ 
$$$=. 

~IFTF 

ENARS 

~IFT 

»PSECT PSCT 

DIRS #$$$,ERR 

.ENDC 

»ENDM ENARSC 


C.2.36  ENARSS Macro 


The ENARSS macro generates the code to push a DPB for the ENABLE AST 
RECOGNITION directive on the stack followed by an EMT 377. 


Macro call: ENARSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the ENABLE AST RECOGNITION directive on the stack. Then an EMT 377 is 
generated using the ERR error Service address as described in the DIR$ 
macro. 


»-MACRO ENARSS ERR 
«MCALL DIRS 

MOV (PC) +,-(SP) 
-BYTE 101.,1 

DIRS ,ERR 

-ENDM ENARSS 


C.2.37 ENARS Macro 


The ENARS macro generates a DPB for the ENABLE AST RECOGNITION 
directive. 


Macro call: ENARS 


Description: This macro generates a DPB for the ENABLE AST 
RECOGNITION directive. There are no parameters. 


MACRO ENARS 
.IF NDF $$SGLB 
»BYTE 101.,1 
.ENDC 

~ENDM ENARS 
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C.2.38 ENCPSC Macro 


The ENCP$SC macro generates a DPB for the ENABLE CHECKPOINTING 
directive in a separate PSECT followed by an EMT 377 in the user 
specified program PSECT. 


Macro call: ENCPSC PSCT,ERR 


Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive in the $DPB$$ program section. Then the macro generates an 
EMT 377 in the program section named in pscr. The DIRS macro 
describes the ERR error service address. 


-MACRO ENCPSC PSCT,ERR 

-MCALL ENCPS ,DIRS 

~IF NDF $SSGLB 

-PSECT S$DPBS$ 
$$$=, 

~IFTF 

ENCPS 

~IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

-ENDM ENCPSC 


C.2.39 ENCPSS Macro 


The ENCP$S macro generates the code to push a DPB for the ENABLE 
CHECKPOINTING directive on the stack followed by an EMT 377. 


Macro call: ENCPSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the ENABLE CHECKPOINTING directive on the stack. Then an EMT 377 is 
generated using the ERR error service address as described in the DIRS 
macro. 


«MACRO ENCPSS ERR 
-MCALL DIRS 

MOV (PC)+,~(SP) 
~-BYTE 97.,1 

DIRS ,ERR 

»-ENDM ENCPSS 


C.2.40 ENCP$ Macro 


The ENCPS macro generates a DPB for the ENABLE CHECKPOINTING 
directive. 


Macro call: ENCPS 


Description: This macro generates a DPB for the ENABLE CHECKPOINTING 
directive. There are no parameters 


«MACRO ENCPS 
-IF NDF S$SSGLB 
»-BYTE 97.,1 
-ENDC 

-ENDM ENCPS 
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C.2.41 ERRS Macro 


ERRS is an internal macro that generates a test for directive failure 
accompanied by a JSR instruction to an error handler. 


Macro call: ERRS ERR 


Description: A set C-bit indicates directive failure. If the ERR 
argument is defined, ERRS$ generates code to test the C-bit and skip if 
not set followed by a JSR to an error handler specified by ERR. 


.MACRO ERRS ERR 

.IF NB <ERR> 

»NLIST 

.NTYPE S$$ST1,ERR 

.LIST 

.IIF EQ “O<$$$T1-27>, BCC .+6 
,IIF EQ “O<$$$T1-37>, BCC .+6 
.IF GE “O<S$S$T1-60> 

BCC .+6 

.IFF 

.IF NE “O<SS$$T1-27> 

.LIF NE “O<$S8$T1-37>, BCC .+4 
~ENDC 

.ENDC 

CALL ERR 

~ENDC 

.ENDM ERRS 


C.2.42 EXIFSC Macro 


THE EXIFSC macro generates a DPB for the EXIT IF directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: EXIFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the EXIT IF directive in 
the SDPBSS program section. The DPB parameters are described in the 
EXIFS macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The EXIF$ macro controls symbolic address generation. 


»MACRO EXIFSC EFN,CS,ERR 
.MCALL EXIFS$ ,DIRS$ 

.IF NDF S$SSGLB 

-PSECT SDPBSS$ 


$$$=. 
.IFTF 
EXIF$ EFN 
IFT 
.PSECT CS 
DIRS #$$$,ERR 
.ENDC 


~ENDM EXIFSC 
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C.2.43 EXIFSS Macro 


The EXIF$S macro generates the code to push a DPB for the EXIT IF 
directive on the stack followed by an EMT 377. 


Macro call: EXIFSS EFN,ERR 


Description: This macro generates the code to push a DPB for the EXIT 
IF directive on the stack. The DPB arguments must be valid assembler 
source operands, and they must specify the information described in 
the EXIF$ macro. This macro also generates an EMT 377 using the ERR 
error service address as described in the DIRS macro. 


-MACRO EXIFSS EFN,ERR 
~MCALL MOVS ,DIRS 

MOVS EFN 

MOV (PC)+,-(SP) 

-BYTE 53.,2 

DIRS ,ERR 

-ENDM EXIFSS 


C.2.44 EXIFS Macro . 
The EXIF$ macro generates 4 DPB for the EXIT IF directive. 
Macro call: EXIFS EFN 


Description: This macro generates a DPB for the EXIT IF directive. 
The argument is assumed to have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 


E.XFEF-(length 2 bytes) Event flag number. 


If the macro is invoked with the symbol $SSGLB defined, EXIFS does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO EXIFS EFN 
-MCALL OFFS 
-IF NDF SSSGLB 
BYTE 53.,2 
»WORD EFN 
-ENDC 

-IF NDF E.XFEF 
-NLIST 

OFFS 

OFFS E.XFEF,2 
-LIST 

~ENDC 

-ENDM EXIFS 


C.2.45 EXITSC Macro 


The EXITSC macro generates a DPB for the TASK EXIT directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: EXITSC PSCT,ERR 
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Description: This macro generates a DPB in the program SECTION SDPBS$ 
followed by an EMT 377 in the PSCT program section. The DIR$ macro 
describes the ERR error service address. 


.MACRO EXITSC PSCT,ERR 

»MCALL EXITS ,DIRS 

-IF NDF $S$SGLB 

-PSECT SDPBS$S$ 
$$$=, 

~IFTF 

EXITS 

IFT 

»PSECT PSCT 

DIRS #5$$$,ERR 

~ENDC 

»ENDM EXITSC 


C.2.46 EXITSS Macro 


The EXITSS macro generates the code to push a DPB for the TASK EXIT 
directive on the stack followed by an EMT 377. 


Macro call: EXITSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the TASK EXIT directive on the stack. ‘Then, EXITSS generates an EMT 
377 using the ERR error service address, as described in the EXITS 
macro. 


»-MACRO EXITSS ERR 
«MCALL DIRS 

MOV (PC)+,-(SP) 

~BYTE 51.,1 

DIRS 

-IIF NB <ERR>, CALL ERR 
»ENDM EXITSS 


C.2.47 EXITS Macro 
The EXITS macro generates a DPB for the TASK EXIT directive. 
Macro call: EXITS 


Description: This macro generates a DPB for the TASK EXIT directive. 
There are no parameters. 


.MACRO EXITS 
-IF NDF $$S$GLB 
-BYTE 51.,1 
-ENDC 

-ENDM EXITS 


C.2.48 EXTKSC Macro 


The EXTKSC macro generates a DPB for the EXTEND TASK directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: EXTKSC INC,PSCT,ERR 
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Description: This macro generates a DPB for the EXTEND TASK directive 
in the S$DPBS$ program section. The DPB parameters are described in 
the EXTK$S macro. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIR$ macro describes the ERR error service 
address. The EXTKS macro controls the generation of symbolic offsets. 


-MACRO EXTKSC INC,CS,ERR 
-MCALL EXTKS ,DIR$ 

~IF NDF $S$GLB 

-PSECT $DPBS$ 


.IFTF 

EXTKS INC 
~IFT 

-PSECT CS 
DIRS #$$$,ERR 
~ENDC 


~ENDM EXTKSC 


C.2.49 EXTKSS Macro 


EXTKSS pushes a DPB for the EXTEND TASK directive on the stack and 
generates an EMT 377. 


Macro call: EXTKSS INC,ERR 


Description: EXTKS$S pushes a DPB for the EXTEND TASK directive on the 
stack. The DPB arguments must be valid assembler operands and they 
must specify the information that the EXTKS macro describes. EXTKSS 
also generates an EMT 377 using the ERR error service address that the 
DIRS macro describes. 


~MACRO EXTKS$S INC,ERR 
«-MCALL MOVS ,DIRS 

CLR -(SP) 

MOVS INC 

MOV (PC)+,-(SP) 

-BYTE 89.,3 

DIR$ ,ERR 

-ENDM EXTKSS 


C.2.50 EXTKS Macro 
The EXTKS macro generates a DPB for the EXTEND TASK directive. 
Macro call: EXTKS INC 


Description: EXTKS generates a DPB for the EXTEND TASK directive. 
The argument must have the following meaning: 


INC=Task size increment in 32 word blocks. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


E.XTIN-(length 2 bytes) Task size increment. 
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If EXTK$ is invoked with the $$$GLB symbol defined, EXTKS does not 
generate the DPB and it globally defines symbolic offsets. 


.MACRO EXTKS INC 
.MCALL OFFS 
-IF NDF $S$SGLB 
-BYTE 89.,3 
-WORD INC 
-WORD 0 

.ENDC 

.IF NDF E.XTIN 
-NLIST 

OFFS 

OFFS E.XTIN,2 
.LIST 

.ENDC 

~ENDM EXTKS 


C.2.51 GLUNSC Macro 


GLUNSC generates a DPB for the GET LUN INFORMATION directive in a 
separate PSECT followed by an EMT 377 in the user specified program 
PSECT. 


Macro call: GLUNSC LUN,BUFADR,PSCT,ERR 


Description: GLUNSC generates a DPB for the GET LUN INFORMATION 
directive in the S$DPBS$ program section and generates an EMT 377 in 
the program section named in PSCT. GLUNS describes the DPB parameters 
and controls symbolic address generation. The DIRS macro describes 
the ERR error service address. 


.MACRO GLUNSC LUN,BUFA,CS,ERR 

.MCALL GLUNS ,DIRS 

-IF NDF SSSGLB 

-PSECT SDPBSS$ 
$$$=. 

.IFTF 

GLUNS LUN,BUFA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

»ENDC 

.ENDM GLUNSC 


C.2.52 GLUNS$S Macro 


GLUNSS generates the code to push a DPB for the GET LUN INFORMATION 
directive on the stack and generates an EMT 377. 


Macro call: GLUNSS LUN,BUFADR,ERR 


Description: GLUNSS generates the code to push a DPB for the GET LUN 
INFORMATION directive on the stack and generates an EMT 377 by using 
the ERR error service address as described in the DIRS macro. GLUNSS 
also generates symbolic offsets relative to the information buffer as 
described in the GLUNS macro. DPB arguments must be valid assembler 
source operands and must specify the information described in the 
GLUNS macro. 
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.MACRO GLUNSS LUN,BUFA,ERR 
-MCALL MOVS ,DIRS ,OFFS 
MOVS BUFA 
MOVS LUN 
MOV (PC)+,-(SP) 
-BYTE 5,3 
DIRS ,ERR 
.IF NDF G.LUNA 
-NLIST 
SSSOST=0 
.IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8.>> 
OFFS X 
.ENDM 
«LIST 
~ENDC 
.ENDM GLUNSS 


C.2.53 GLUNS$ Macro 


The GLUNS macro generates a DPB for the GET LUN INFORMATION directive. 
Macro call: GLUN$ LUN,BUFADR 


Description: This macro generates a DPB for the GET LUN INFORMATION 
directive. The arguments are assumed to have the following meaning: 


LUN=Logical unit number, 
BUFADR=Address of six-word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


G.LULU-(length 2 bytes) Logical unit number, 
G.LUBA-(2) Buffer address, 
G.LUBL-(2) Buffer length. 


The following symbols are assigned relative to the start of the LUN 
information buffer: 


G.LUNA-(2) Device name, 

G.LUNU-(1) Device unit number, 

G.LUFB-(1) Flags byte, 

G.LUCW-(8) Four device characteristic words. 


If the macro is invoked with the $$GLB symbol defined, GLUNS does not 
generate the DPB and it globally defines the symbolic offsets. 


».MACRO GLUNS LUN,BUFA 

.MCALL OFFS 

.IF NDF $$$GLB 

-BYTE 5,3 

.WORD LUN 

-WORD BUFA 

.ENDC 

.IF NDF G.LULU 

-NLIST 

.IRP X,<,<G.LULU,2>,<G.LUBA,2>,<G.LUBL,2>> 

OFFS X 

.ENDM 

.IF NDF G.LUNA 
$SSOST=0 
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-IRP X,<<G.LUNA,2>,<G.LUNU,1>,<G.LUFB,1>,<G.LUCW,8.>> 
OFFS X 

-ENDM 

»ENDC 

-LIST 

-ENDC 

~ENDM GLUNS 


C.2.54 GMCRSC Macro 


GMCRSC generates a DPB for the GET MCR COMMAND LINE directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: GMCRSC PSCT,ERR 


Description: GMCRSC generates a DPB for the GET MCR COMMAND LINE 
directive in the S$DPBS$ program section and generates an EMT 377 in 
the program section named in PSCT. GMCRS describes the DPB parameters 
and controls symbolic address generation. DIRS describes the ERR 
error service address. 


»-MACRO GMCRSC CS,ERR 
»-MCALL GMCRS ,DIRS 
-IF NDF $SSGLB 
-PSECT SDPBS$ 

$$$=,. 


-PSECT CS 
DIR$ #$$$,ERR 
- ENDC 

-ENDM GMCRSC 


C.2.55 GMCR$ Macro 


The GMCRS macro generates a DPB for the GET MCR COMMAND LINE 
directive. 


Macro call: GMCR$ 


Description: This macro generates a DPB for the GET MCR COMMAND LINE 
directive. GMCR$ locally defines the following symbol with its 
assigned value equal to the byte offset from the start of the DPB to 
the DPB element: 


G.MCRB-(length 80 bytes) MCR line buffer 


If the macro is invoked with the $$$GLB symbol defined, GMCR$ does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO GMCRS$ 
-MCALL OFFS 
-IF NDF $$S$GLB 
-BYTE 127.,41. 
-BLKW 40. 
.ENDC 

-IF NDF G.MCRB 
»NLIST 

OFFS 
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OFFS G.MCRB,80. 
»~LIST 

-ENDC 

*.ENDM GMCRS$ 


C.2.56 GPRTSC Macro 


GPRTSC generates a DPB for the GET PARTITION PARAMETERS directive ina 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: GPRT$C PRTNAM,BUFADR,PSCT,ERR 


Description: GPRT$C generates a DPB for the GET PARTITION PARAMETERS 
directive in the SDPBS$ program section and generates an EMT 377 in 
the program section named in PSECT. GPRTS describes the DPB 
parameters and controls symbolic offset generation. DIRS describes 
the ERR error service address. 


.MACRO GPRTSC PRT,BUF,CS,ERR 

.MCALL GPRTS ,DIRS 

-IF NDF $$$GLB 

»PSECT S$DPBS$ 
$$$=. 

.IFTF 

GPRTS PRT,BUF 

IFT 

»PSECT CS 

DIRS #$$$,ERR 

. ENDC 

.ENDM GPRTSC 


C.2.57 GPRT$S Macro 


GPRTSS generates the code to push a DPB for the GET PARTITION 
PARAMETERS directive on the stack and generates an EMT 377. 


Macro call: GPRTSS PRTNAMADR,BUFADR,ERR 


Description: GPRT$S generates the code to push a DPB for the GET 
PARTITION PARAMETERS directive on the stack and generates an EMT 377 
using the ERR error service address described in the DIRS macro. The 
DPB arguments must be valid assembler source operands and they must 
specify the information described in the GPRT$ macro. GPRT$S also 
generates symbolic offsets relative to the start of the partition 
parameters buffer described in the GPRT$ macro. 


.MACRO GPRTSS PRT,BUF,ERR 
.MCALL MOVS ,RFAS ,DIRS ,OFFS 
MOVS BUF 
RFAS PRT 
MOV (PC) +,-(SP) 
-BYTE 65.,4 
DIR$ ,ERR 
.IF NDF G.PRPB 
-NLIST 
$$SOST=0 
.IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 
OFFS X 
.ENDM 
-LIST 
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~ENDC 
-ENDM GPRTSS 


C.2.58 GPRTS Macro 


The GPRTS macro generates a DPB for the GET PARTITION PARAMETERS 
directive. 


Macro call: GPRTS PRTNAM,BUF 


Description: This macro generates a DPB for the GET PARTITION 
PARAMETERS directive. The arguments are assumed to have the following 
meanings: 


PRINAM=Partition name, 
BUFADR=Address of three word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


G.PRPN-(length 4 bytes) Partition name, 
G.PRBA-(2) Buffer address. 


The following offsets are assigned relative to the start of the 
partition parameters buffer: 


G.PRPB-(2) 1/64 Partition base address, 
G.PRPS-(2) 1/64 Partition size, 
G.PRFW-(2) Partition flags word. 


If GPRTS is invoked with the $$$GLB symbol defined, GPRT$ does not 
generate the DPB and it globally defines the symbolic offsets. 


.MACRO GPRTS PRT,BUF 

-MCALL OFFS,R50$ 

-IF NDF $SSGLB 

-BYTE 65.,4 

R50$ PRT 

.WORD BUF 

.ENDC 

.IF NDF G.PRPN 

-NLIST 

OFFS 

OFFS G.PRPN,4 

OFFS G.PRBA,2 

.IF NDF G.PRPB 
$SSOST=0 

-IRP X,<<G.PRPB,2>,<G.PRPS,2>,<G.PRFW,2>> 

OFFS X 

.ENDM 

-ENDC 

~LIST 

-ENDC 

-ENDM GPRTS 
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C.2.59 GSSWSC Macro 


The GSSWSC macro generates a DPB for the GET SENSE SWITCHES directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GSSWSC PSCT,ERR 


Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive in the S$DPBS$ program section followed by an EMT 377 in the 
user specified program section PSCT. The DIRS macro describes the ERR 
error service address. 


«MACRO GSSWSC PSCT,ERR 

-MCALL GSSWS$ ,DIRS 

-IF NDF $SSGLB 

-PSECT SDPBS$ 
$$$=. 

.IFTF 

GSSWs 

An 

.PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

~ENDM GSSWSC 


C.2.60 GSSWSS Macro 


The GSSW$S macro generates the code to push a DPB for the GET SENSE 
SWITCHES directive on the stack followed by an EMT 377. 


Macro call: GSSWSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the GET SENSE SWTICHES directive on the stack. Then it generates an 
EMT 377 using the error service address as described in the DIR§ 
macro, 


-MACRO GSSWSS ERR 
-MCALL DIRS 

MOV (PC)+,-(SP) 
~-BYTE 125.,1 

DIRS ,ERR 

-ENDM GSSWSS 


C.2.61 GSSWS Macro 


The GSSWS macro generates a DPB for the GET SENSE SWITCHES directive. 


Macro call: GSSWS$ 


Description: This macro generates a DPB for the GET SENSE SWITCHES 
directive. There are no arguments. 


-MACRO GSSWS 
-IF NDF $$S$GLB 
-BYTE 125.,1 
»ENDC 

-ENDM GSSWS 
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C.2.62 GTIMSC Macro 


The GTIM$C macro generates a DPB for the GET TIME PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GTIMSC BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive in the $DPBS$ program section. The GTIM$ macro describes 
the DPB parameters. This macro then generates an EMT 377 in the 
program section named in PSCT. The DIR$ macro describes the ERR error 
service address. The GTIMS macro controls symbolic address 
generation. 


»-MACRO GTIMSC BUFA,CS ERR 

-MCALL GTIMS ,DIRS 

.IF NDF S$SSSGLB 

»-PSECT SDPBS$S$ 
$S$S$=, 

-IFTF 

GTIMS BUFA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

»ENDC 

.ENDM GTIMSC 


C.2.63 GTIMS$S Macro 


The GTIMSS macro generates the code to push a DPB for the GET TIME 
PARAMETERS directive on the stack followed by an EMT 377. 


Macro call: GTIMSS BUFADR,ERR 


Description: This macro generates the code to push a DPB for the GET 
TIME PARAMETERS directive on the stack. The DPB arguments must be 
valid assembler source operands, and they must specify the information 
described in the GTIM$ macro. This macro also generates an EMT 377 
using the ERR error service address, as described in the DIRS macro. 
This macro also generates symbolic offsets relative to the time 
parameters buffer as described in the GTIM$ macro. 


-MACRO GTIMSS BUFA,ERR 
-MCALL MOVS ,DIRS ,OFF$ 
MOVS BUFA 
MOV (PC) +,-(SP) 
-BYTE 61.,2 
DIRS ,ERR 
.IF NDF G.TIYR 
-NLIST 
SSSOST=0 
.IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 
OFFS X 
.ENDM 
.IRP X,<<G.TIMI ,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 
OFFS X 
-ENDM 
.LIST 
»ENDC 
-ENDM GTIMSS 
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C.2.64 GTIMS Macro 
The GTIMS macro generates a DPB for the GET TIME PARAMETERS directtve. 
Macro call: GTIMS BUFADR 


Description: This macro generates a DPB for the GET TIME PARAMETERS 
directive. The argument is assumed to have the following meaning: 


BUFADR=Address of eight word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the element: 


G.TIBA-(length 2 bytes) Buffer address. 


The following offsets are assigned relative to the start of the time 
parameters buffer: 


G.TIYR-(2) Year, 

G.TIMO-(2) Month, 

G.TIDA-(2) Day, 

G.TIHR-(2) Hour, 

G.TIMI~(2) Minute, 

G.TISC~-(2) Second, 

G.TICT-(2) Clock tick, 

G.TICP-(2) Clock ticks per second. 


If GTIMS is invoked with the $$$GLB symbol defined, GTIM$ does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO GTIMS BUFA 

-MCALL OFFS 

-IF NDF S$SSGLB 

-BYTE 61.,2 

-WORD BUFA 

-ENDC 

.IF NDF G.TIBA 

-NLIST 

OFFS 

OFFS G.TIBA,2 

-IF NDF G.TIYR 
$$SOST=0 

-IRP X,<<G.TIYR,2>,<G.TIMO,2>,<G.TIDA,2>,<G.TIHR,2>> 

OFFS X 

.ENDM 

~-IRP X,<<G.TIMI ,2>,<G.TISC,2>,<G.TICT,2>,<G.TICP,2>> 

OFFS X 

.ENDM 

-ENDC 

-LIST 

.ENDC 

~ENDM GTIMS 


C.2.65 GTSKSC Macro 

The GTSKSC macro generates a DPB for the GET TASK PARAMETERS directive 
in a separate PSECT followed by an EMT 377 in the user specified 
PSECT. 


Macro call: GTSKSC BUFADR,PSCT,ERR 
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Description: This macro generates a DPB for the GET TASK PARAMETERS 
directive in the $DPB$$ program section. The GTSK$S macro describes 
the DPB parameters. This macro then generates an _ EMT 377 in the 
original program control section named in PSCT. The DIRS macro 
describes the ERR error service address. The GTSKS$ macro controls 
symbolic offset generation. 


.MACRO GTSKSC BUFA,CS,ERR 

.MCALL GTSKS$ ,DIR$ 

-IF NDF $SSGLB 

-PSECT SDPBS$S$ 
$$$=, 

~IFT 

GTSKS$ BUFA 

.IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

.ENDM GTSKSC 


C.2.66 GYSK$S Macro 


The GTSKSS macro generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack followed by an EMT 377. 


Macro call: GTSK$S BUFADR,ERR 


Description: GTSK$S generates the code to push a DPB for the GET TASK 
PARAMETERS directive on the stack. The DPB arguments must be valid 
assembler source operands and they must specify the information 
described in the GTSK$ macro. GTSKSS generates an EMT 377 using the 
ERR error service address, as described in the DIRS macro. GTSKSS 
also generates symbolic offsets relative to the task parameters buffer 
as described in the GTSK$ macro. 


.MACRO GTSKSS BUFA,ERR 
.MCALL MOVS ,DIRS ,OFFS$ 
MOVS BUFA 
MOV (PC)+,-(SP) 
-BYTE 63.,2 
DIRS ,ERR 
.IF NDF G.TSTN 
.NLIST 
$ssosT=0 
,IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 
OFFS X 
.ENDM 
.IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 
ViZ 
OFFS G.TSTS,2 
OFFS G.TSSY,2 
OFFS G.TSDU,2 
$$$OST=0 
.IRP X,<<RX$11D,1>,<RX$11M,1>,<RX$11S,1>,<RXSIAS ,1>> 
OFFS X 
.ENDM 
-LIST 
.ENDC 
.ENDM GTSKSS 
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C.2.67 GTSKS$ Macro 
The GTSKS macro generates a DPB for the GET TASK PARAMETERS directive. 
Macro call: GTSKS$ BUFADR 


Description: 
directive. 


GTSKS generates a DPB for the GET TASK PARAMETERS 
The argument is assumed to have the following meaning: 


BUFADR=Address of a 16 word buffer. 


The following symbol is locally defined with its assigned value equal 

to the byte offset from the start of the DPB to the DPB element: 
G.TSBA~(length 2 bytes) Buffer address. 

The following offsets are assigned relative to the start of the task 


parameters buffer: 


G.TSTN- (4) 
G.TSPN- (4) 
G.TSRN- (4) 


Task name 
Partition name 
Name of task's requester 


G.TSPR-(2) Priority 

G.TSGC-(1) UIC group code 

G.TSPC-(1) UIC programmer code 

G.TSNL-(2) Number of logical units 

G.TSMT-(2) Machine type 

G.TSFW-(2) Std flags word 

G.TSVA-(2) Address of task SST vector eabie 

G.TSVL-(2) Length (number of words) of task SST vector table 
G.TSTS-(2) Size (in bytes) of task address space 

G.TSSY-(2) System in which task is running: 


RX$11D - System is RSX-11D 
RXS11M - System is RSX-11M 
RX$11S - System is RSX-115 
RXSIAS - System is IAS 


G.TSDU- (2) 


If GTSKS$ is invoked with the $SS$GLB symbol 
generate the DPB and it globally defines the symbolic offsets. 


Task's (default) protection UIC 


defined, GTSKS does 


-MACRO GTSKS BUFA 
»MCALL OFFS 

»IF NDF S$$SGLB 
»BYTE 63.,2 

»WORD BUFA 


»ENDC 


»IF NDF G.TSBA 


-NLIST 
OFFS 


OFFS G.TSBA,2 
-IF NDF G.TSTN 


S$SOST=0 


not 


~IRP X,<<G.TSTN,4>,<G.TSPN,4>,<G.TSRN,4>,<G.TSPR,2>,<G.TSPC,1>> 


OFFS X 
»-ENDM 


~IRP X,<<G.TSGC,1>,<G.TSNL,2>,<G.TSMT,2>,<G.TSFW,2>,<G.TSVA,2>> 


OFFS X 
»-ENDM 


OFFS G.TSVL,2 
OFFS G.TSTS,2 
OFF$ G.TSSY,2 
OFFS G.TSDU,2 


$$sost=0 
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-IRP X,<<RX$11D,1>,<RXS11M,1>,<RX$11S,1>,<RXS$IAS ,1>> 
OFFS X 

-ENDM 

»ENDC 

-LIST 

» ENDC 

«ENDM GTSK$ 


C.2.68 IHARSC Macro 


The IHARSC macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in a separate PSECT followed by an EMT 377 in 
the user specified PSECT. 


Macro call: IHARSC PSCT,ERR 


Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive in the $DPB$$ program section followed by an EMT 
377 in the user specified program section named PSCT. The DIR$ macro 
describes the ERR error service address. 


Note: This macro is the same as the DSARSC macro, and is included 
only for compatibility with RSX-11D. 


.MACRO IHARSC PSCT,ERR 
»~MCALL DSARSC 


DSARSC PSCT,ERR 
~ENDM IHARSC 


C.2.69 IHARSS Macro 


The IHARSS macro generates the code to push a DPB for the INHIBIT AST 
RECOGNITION directive on the stack and an EMT 377. 


Macro call: IHARSS ERR 
Description: This macro generates the code to push a one-word DPB for 
the DISABLE AST RECOGNITION directive on the stack. Then the macro 
generates an EMT 377 using the ERR error service address described in 
the DIRS macro. 
Note: This macro is included only for compatibility with RSX-11D. 
».MACRO IHARSS ERR 
»MCALL DSARSS 


DSAR$S ERR 
.ENDM IHARSS 


C.2.70 IHAR$ Macro 


The IHARS macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. 


Macro call: IHAR$ 


Description: This macro generates a DPB for the INHIBIT DISABLE AST 
RECOGNITION directive. There are no parameters. 


C-37 
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Note: This macro is included only for compatiblity with RSX-11D. 


-MACRO IHARS 
-MCALL DSARS 
DSARS 

-ENDM IHARS 


C.2.71 MOVS Macro 
This is an internal macro that pushes an argument on the stack. 
Macro call: MOVS <ARG> 


Description: MOVS pushes an argument on the stack. MOVS examines the 
argument first to determine which code is valid to perform the push. 
If the argument is left blank, MOVS uses a CLR instruction. 
Otherwise, MOVS generates a "MOV ARG,-(SP)" instruction. 


-MACRO MOVS ARG 
-IF NB <ARG> 

-IF DIF <ARG>,<#0> 
MOV ARG,- (SP) 
~MEXIT 

-ENDC 

~ENDC 

CLR -(SP) 

-ENDM MOVS 


C.2.72 MRKTSC Macro 


The MRKTSC macro generates a DPB for the MARK TIME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: MRKTSC EFN,TIMMAG,TIMUNIT,AST,PSCT,ERR 


Description: This macro generates a DPB for the MARK TIME directive 
in the $DPBSS program section. The MRKTS macro describes the DPB 
parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The DIRS macro describes the ERR error service 
address. The MRKTS$ macro controls the generation of symbolic offsets. 


-MACRO MRKTSC EF,TM,TU,AST,CS,ERR 

-MCALL MRKTS ,DIR$S 

-IF NDF $S$GLB 

~PSECT $DPBS$ 
$$$=. 

«LFTFP 

MRKTS EF,TM,TU,AST 

-IFT 

»-PSECT CS 

DIRS #$$$,ERR 

eENDC 

~ENDM MRKTSC 
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C.2.73 MRKTSS Macro 


The MRKTSS macro generates the code to push a DPB for the MARK TIME 
directive on the stack followed by an EMT 377. 


Macro call: MRKTS$S EFN,TIMMAG,TIMUNIT,AST,ERR 


Description: This macro generates the code to push a DPB for the MARK 
TIME directive on the stack. The DPB arguments must be valid 
assembler source operands and they must specify the information 
described in the MRKTS macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIRS macro. 


»MACRO MRKTSS EF,TM,TU,AST,ERR 
-MCALL RVPS$ ,DIRS 

RVP$ EF,TM,TU,AST 

MOV (PC)+,-(SP) 

~BYTE 23.,5 

DIRS ,ERR 

«ENDM MRKT$S 


C.2.74 MRKT$ Macro 
The MRKTS macro generates a DPB for the MARK TIME DIRECTIVE. 
Macro call: MRKT$ EFN,TIMMAG,TIMUNIT,AST 


Description: This macro generates a DPB for the MARK TIME directive. 
The arguments are assumed to have the following meanings: 


EFN=Event flag number, 
TIMMAG=Time interval magnitude, 
TIMUNIT=Time interval unit, 
AST=AST entry address. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


M.KTEF-(length 2 bytes) Event flag, 
M.KTMG-(2) Time magnitude, 
M.KTUN-(2) Time unit, 

M.KTAE~(2) AST entry address. 


If MRKTS$ is invoked with the $$$GLB symbol defined, MRKTS does not 
generate the DPB and globally defines the symbolic offsets. 


»MACRO MRKTS EFN,TM,TU,AST 
«MCALL OFFS 

-IF NDF $S$SGLB 

-BYTE 23.,5 

«WORD EFN 

-WORD TM 

-WORD TU 

.WORD AST 

~ENDC 

.IF NDF M.KTEF 

.NLIST 

.IRP X,<,<M.KTEF,2>,<M.KTIMG,2>,<M.KTUN,2>,<M.KTAE,2>> 
OFFS X 

.ENDM 

-LIST 
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~ENDC 
~ENDM MRKTS 


C.2.75 MVBS Macro 
MVBS is an internal macro that pushes two bytes on the stack. 
Macro call: MVBS LOWB,HIGHB 


Description: MVBS examines the two arguments and based on that 
examination generates the code to push the bytes on the stack. 


»MACRO MVBS LOW,HIGH 


-IF B <LOW> 
~IF B <HIGH> 
CLR ~(SP) 
~IFF 

CLRB -(SP) 
MOVB HIGH,1(SP) 
- ENDC 

~IFF 

-IF B <HIGH> 
CLR -(SP) 
MOVB LOW, (SP) 
-IFF 


MOVB LOW,-(SP) 
MOVB HIGH,1(SP) 
«ENDC 

- ENDC 

-ENDM MVBS$ 


C.2.76 OFFS Macro 
OFFS is an internal macro that generates symbolic offsets. 
Macro call: OFFS SYMB,LEN 


Description: OFFS creates tables of symbolic offsets for the elements 
within DPBs. The first argument, SYMB, is the name of the symbol. 
The second argument, LEN, is the length of the symbol in bytes. OFFS 
adds LEN to the offset counter after OFFS makes the symbolic 
assignment. If the $S$GLB symbol is defined, OFFS makes the symbolic 
assignments global. Otherwise, OFFS makes all assignments local. 


If both SYMB and LEN are blank, OFFS initializes the offset counter to 
two (2). 


-MACRO OFFS SYMB,LEN 

-IF B <'SYMB'LEN> 
SSSOST=2 

.MEXIT 

~ENDC 

.IF NB <SYMB> 

.IF NDF SSSGLB 
SYMB=SSSOST 

-IFF 
SYMB==SSSOST 

-ENDC 

- ENDC 
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C.2.77 QDPBSS Macro 


The QDPBSS macro generates the code to push a QUEUE I/O or QUEUE I/O 
AND WAIT DPB on the stack and it generates an EMT 377. 


Macro call: QDPBSS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 


Description: This macro generates the code to push the proper QUEUE 
I/O DPB on the stack. It is meant to be called only by QIOSS, or 
QIOWSS to generate the required code to build a DPB and issue the EMT 
377 


.MACRO QDPBSS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 

»MCALL RVPS ,MVBS ,DIRS$ 

.NLIST 
SSSARG=0 

.IRP X,<PRMLST> 
SSSARG=SSSARG+1 

~ENDM 

~LIST 

~IF GT 6-SSSARG 

.REPT <6-SSSARG> 

CLR -(SP) 

~ENDR 

»ENDC 

.LIF NB <PRMLST>, RVPS PRMLST 

RVPS IOST,AST 

MVBS EFN, 

RVPS FNC,LUN 

MOV (PC)+,-(SP) 

sBYTE DIC,12. 

DIRS ,ERR 

.ENDM QDPBSS 


C.2.78 QDPB$ Macro 
The QDPBS macro generates the QUEUE I/O or QUEUE I/O AND WAIT DPB. 
Macro call: QDPBS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST 


Description: This macro generates the required DPB for the specified 
QUEUE I/O directive. It is only meant to be called by the QIOS, 
QIOSC, QIOWS, OR QIOWSC macros to generate the required DPB. 


.MACRO QDPBS DIC,FNC,LUN,EFN,PRI,IOST,AST,PRMLST 
-MCALL OFFS 
-IF NDF $$SGLB 
~-BYTE DIC,12. 
.WORD FNC 
»WORD LUN 
.BYTE EFN,0O 
-WORD IOST 
-WORD AST 
.NLIST 
SSSARG=0 
-LIST 
.IRP X,<PRMLST> 
~WORD X 
-NLIST 
SSSARG=SSSARGt1 
.LIST 
.ENDM 
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-IF GT 6-SSSARG 

»REPT <6-SSSARG> 

»-WORD 0 

.ENDR 

»ENDC 

~ENDC 

.IF NDF Q.IOFN 

-NLIST 

~IRP X,<,<Q.IOFN,2>,<Q.IOLU,2>,<Q.IOEF,1>,<Q.IOPR,1>> 
OFFS X 

»ENDM 

»IRP X,<<Q.IOSB,2>,<Q.IOAE,2>,<Q.IOPL>> 
OFFS X 

-ENDM 

-LIST 

.ENDC 

-ENDM QDPBS 


C.2.79 QIOSC Macro 


The QIOSC macro generates a QUEUE I/O DPB in a separate PSECT followed 
by an EMT 377 in the user specified PSECT. 


Macro call: QIOSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSECT,ERR 


Description: This macro generates the required QUEUE I/O DPB in the 
SDPBS$$ program section. All of the arguments through PRMLST are as 
described for the QIO$S macro. The PSECT argument should be the name 
of the original program program section into which the standard 
monitor trap code is generated. The optional argument, ERR, is’ the 
error routine address. This macro invokes QIO$ and, therefore, 
follows the same expansion guidelines. 


Note: Read the note in the QIOS macro description concerning ignored 
arguments in the QIOS macro below. 


»MACRO QIOSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSCT,ERR 
-MCALL QDPBS,DIRS 
-IF NDF $S$SGLB 
»PSECT S$DPBS$ 
$$s=,. 
~IFTF 
QDPBS 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
IFT 
-PSECT PSCT 
DIRS #$$5,ERR 
-ENDC 
-ENDM QIOSC 


C.2.80 QIO$S Macro 


The QIO$S macro generates the code to push a QUEUE I/0 DPB on _ the 
stack and generate an EMT 377. 


Macro call: QIO$SS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 


Description: This macro generates the code to push the required queue 
I/O DPB on the stack. The arguments through PRMLST represent the 
information as described in the macro QIOS. However, the arguments 
Must all be valid assembler source operands. 
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Note: Read the note in the QIO$ macro description concerning ignored 
arguments in the QIO$ macro below. 


-MACRO QIOSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 
-MCALL QDPBSS 

QDPBSS 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST>,ERR 
~-ENDM QIOSS 


C.2.81 QIO$ Macro 
The QIO$ macro generates the QUEUE I/O DPB. 
Macro call: QIOS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 


Description: This macro generates the required DPB specified for the 
QUEUE I/O directive. The arguments are treated as follows: 


FNC-I/O Function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Priority, 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 
PRMLST-Parameter list of the form <Pl,...,P6> 


All of the arguments must be valid expressions to be used in assembler 
data storage directives. The first call of this macro defines the 
following symbols and assigns, as a value, their byte offset from the 
beginning of the DPB: . 


Q.IOFN-(length 2 bytes) I/O function, 
Q.IOLU-(2) Logical unit number, 

Q.IOEF-(1) Event flag number, 

Q.IOPR-(1) Priority, 

Q.IOSB-(2) Address of I/O status block, 
Q.IOAE-(2) Address of I/O done AST entry point, 
Q.IOPL-(0) Parameter list (up to 6 words). 


If the $$SSGLB symbol is defined, QIO$ does not generate the DPB and it 
globally defines the symbolic offsets. 


Note: The argument PRI is required to maintain compatibility with 
RSX-11D. Desite the fact that it must be specified, the QIO$ macro 
ignores it. 

»~MACRO QIOS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 

-MCALL QDPBS 


QDPB$ 1,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
»ENDM QIOS 


C.2.82 QIOWSC Macro 


The QIOWSC macro generates a QUEUE I/O AND WAIT DPB in a_e separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: QIOWSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSECT,ERR 


Description: This macro generates the required QUEUE I/O AND WAIT DPB 
in the program section named $DPBS$. All of the arguments through 
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PRMLST are as described for the QIOWS macro. The argument PSECT 
should be the name of the original program program section into which 
the standard monitor trap code is generated. The optional argument, 
ERR, is the error routine address. 


Note: Read the note concerning ignored arguments in the QIOWS macro 
below. 


.MACRO QIOWSC FNC,LUN,EFN,PRI,IOST,AST,PRMLST,PSCT,ERR 
.MCALL QDPBS ,DIRS 
-IF NDF $S$$GLB 
-PSECT SDPBSS$ 
$$S$=, 
~IFTF 
QDPBS 3,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
IFT 
.PSECT PSCT 
DIRS #$$$,ERR 
»ENDC 
-ENDM QIOWSC 


C.2.83 QIOWSS Macro 


The QIOWSS macro generates the code to push a queve I/O and wait DPB 
on the stack and generate an EMT 377. 


Macro call; QIOWSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR QIOWSS Macro 


Description: This macro generates the code to push the required QUEUE 
I/O AND WAIT DPB on the stack. The arguments through PRMLST represent 
the information as described in the QIOWS macro. However, the 
arguments must all be valid assembler source operands. 


Note: Read the note concerning ignored arguments in the QIOWS macro 
below. 


-MACRO QIOWSS FNC,LUN,EFN,PRI,IOST,AST,PRMLST,ERR 
-MCALL QDPBSS 

QDPBSS 3,FNC,LUN,EFN,PRI ,IOST,AST,<PRMLST> ,ERR 
-ENDM QIOWSS 


C.2.84 QIOWS Macro 
The QIOWS macro generates the QUEUE I/O AND WAIT DPB. 
Macro call: QIOWS FNC,LUN,EFN,PRI ,IOST,AST,PRMLST 


Description: This macro generates the required DPB specified for the 
QUEUE I/O AND WAIT directive. The arguments are treated as follows: 


FNC-I/O function code, 

LUN-Logical unit number, 

EFN-Event flag number, 

PRI-Priority, 

IOST-Address of I/O status block, 

AST-Address of I/O done AST entry point 
PRMLST-Parameter list of the form <Pl,...,P6> . 


All of the arguments must be valid expressions to be used in assembler 
data storage directives, The first call of this macro defines the 
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following symbols and assigns, as values, their byte offset from the 
beginning of the DPB: 


Q.IOFN-(Length 2 bytes) I/O function, 
Q.IOLU-(2) Logical unit number, 

Q.IOEF-(1) Event flag number, 

Q.IOPR-(1) Priority, 

Q.IOSB-(2) Address of I/O status block, 
Q.IOAE-(2) Address of I/O done AST entry point, 
Q.IOPL-(0) Parameter list (up to 6 words). 


If the $S$GLB symbol is defined, QIOWS does not generate the DPB and 
it globally defines the symbolic offsets. 


Note: This macro requires the PRI argument to maintain compatibility 
with RSX-11D. Despite the fact that it must be specified, QIOWS 
ignores it. 


.MACRO QIOWS FNC,LUN,EFN,PRI,IOST,AST,PRMLST 
»MCALL QDPBS$ 

QDPBS 3,FNC,LUN,EFN,PRI,IOST,AST,<PRMLST> 
-ENDM QIOWS 


C.2.85 R50$ Macro 
This internal macro generates a two-word RADIX-50 name. 
Macro call: R50S NAME 


Description: This macro converts the NAME argument into RADIX-50 
using the .RAD50 assembler directive. Furthermore, R50$ ensures that 
the data generated is at least two words long. 


.MACRO R50S NAME 
-NLIST 
»NCHR $SST1,NAME 
.LIST 
-IF EQ $S$T1 
-WORD 0,0 
-IFF 
-IF GT $$$T1-6 
SSST4=.+4 
-IFTF 
»RAD50 /NAME/ 
IFT 
~=SS$T4 
»ENDC 
-IIF LT $$$T1-4, .WORD 0 
~ENDC 
»ENDM R50$ 


C.2.86 RCVD$C Macro 


RCVD$C generates a DPB for the RECEIVE DATA directive in a separate 
PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RCVDSC TASK,BUFADR,PSCT,ERR 


Description: RCVDSC generates a DPB for the RECEIVE DATA directive in 
the S$DPB$$ program section. RCVDS describes the DPB parameters. 
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RCVDSC then generates an EMT 377 in the program section named in PSCT. 
DIRS describes the ERR error service address. RCVDS controls the 
generation of symbolic offsets. 


.MACRO RCVDSC TN,BA,CS,ERR 

-MCALL RCVDS ,DIRS 

-IF NDF $$$GLB 

»PSECT $DPBS$ 
$$$=, 

-IFTF 

RCVDS TN,BA 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

.ENDM RCVDSC 


C.2.87 RCVDSS Macro 


The RCVDSS macro generates the code to push a DPB for the RECEIVE DATA 
directive on the stack followed by an EMT 377. 


Macro call: RCVDSS TSKNAMADR,BUFADR,ERR 


Description: This macro generates the code to push a DPB for. the 
RECEIVE DATA directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RCVDS macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIRS macro. 


»MACRO RCVDSS TN,BA,ERR 
-MCALL MOVS ,DIRS, RFAS 
MOVS BA 

RFA$ TN 

MOV (PC)+,-(SP) 

-BYTE 75.,4 

DIRS ,ERR 

-ENDM RCVDSS 


C.2.88 RCVDS Macro 
The RCVDS macro generates a DPB for the RECEIVE DATA directive. 
Macro call: RCVDS TASK,BUFADR 


Description: This macro generates a DPB for the RECEIVE DATA 
directive. The arguments are assumed to have the following meanings: 


TASK=Sender task name, 
BUFADR=Address of fifteen word buffer. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.VDTN-(length 4 bytes) Task name, 
R.VDBA-(2) Buffer address. 


If RCVD$ is invoked with the $$SGLB symbol defined, RCVDS does not 
generate the DPB and it globally defines the symbolic offsets. 


MACRO EXPANSIONS 


-MACRO RCVDS TN,BA~ 
-MCALL OFFS, R50$ 
-IF NDF $$SGLB 
~-BYTE 75.,4 

R50$ TN 

-WORD BA 

»ENDC 

-IF NDF R.VDTN 
-NLIST 

~IRP X,<,<R.VDIN,4>,<R.VDBA,2>> 
OFFS X 

»ENDM 

-LIST 

~ENDC 

-ENDM RCVD$ 


C.2.89 RCVXSC Macro 


The RCVXSC macro generates a DPB for the RECEIVE DATA OR EXIT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: RCVXSC TASK,BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
DIRECTIVE in the program section named S$DPBSS. The RCVXS macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The ERR error service address is 
described in the DIRS macro. The RCVX$ macro controls the generation 
of symbolic offsets. 


~MACRO RCVXSC TN,BA,CS,ERR 

.MCALL RCVXS$ ,DIRS 

-IF NDF S$S$SGLB 

-PSECT SDPBSS$ 
$$$=,. 

~IFTF 

RCVX$ TN,BA 

.IFT 

~PSECT CS 

DIRS #$$$,ERR 

.ENDC 

~ENDM RCVXSC 


C.2.90 RCVXSS Macro 


The RCVX$SS macro generates the code to push a DPB for the RECEIVE DATA 
OR EXIT directive on the stack followed by an EMT 377. 


Macro call: RCVX$S TSKNAMADR,BUFADR,ERR 


Description: This macro generates the code to push a DPB for _ the 
RECEIVE DATA OR EXIT directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the RCVX$ macro. This macro also generates 
an EMT 377 using the ERR error service address as defined in the DIRS 
macro. 


-MACRO RCVXSS TN,BA,ERR 
~MCALL MOVS,DIRS, RFAS 


MACRO EXPANSIONS 


MOVS BA 

RFAS TN 

MOV (PC)+,-(SP) 
~-BYTE 77.,4 
DIRS ,ERR 
-ENDM RCVXSS 


C.2.91 RCVXS$ Macro 


The RCVX$ macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. 


Macro call: RCVX$ TASK,BUFADR 


Description: This macro generates a DPB for the RECEIVE DATA OR EXIT 
directive. The arguments are assumed to have the following meanings: 


TASK=Sender task name, 
BUFADR=Address of fifteen word buffer. 


The following symbols are locally defined with their assigned values 


equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.VXTN-(length 4 bytes) Task name, 
R.VXBA-(2) Buffer address. 


If RCVX$ is invoked with the $$SGLB symbol defined, RCVXS does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO RCVXS TN,BA 
-MCALL OFFS, R50$ 
-IF NDF SSSGLB 
~BYTE 77.,4 

R50$ TN 

-WORD BA 

- ENDC 

.IF NDF R.VXTIN 
-NLIST 

-IRP X,<,<R.VXTN,4>,<R.VXBA,2>> 
OFFS X 

-ENDM 

-LIST 

»ENDC 

-ENDM RCVXS$ 


C.2.92 RDAFSC Macro 


The RDAFSC macro generates a DPB for the READ ALL FLAGS directive ina 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RDAFSC BUFADR,PSCT,ERR 


Description: This macro generates a DPB for the READ ALL FLAGS 
directive in the program section named SDPBS$. The DPB parameters are 
described in the RDAF$ macro. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address. The RDAFS macro controls symbolic address 
generation. 


MACRO EXPANSIONS 


-MACRO RDAFSC BA,CS,ERR 
-MCALL RDAFS$,DIRS 
-IF NDF SSSGLB 
-PSECT $DPBS5 
$$S=,. 


-PSECT CS 
DIRS #$5$,ERR 
»ENDC 

-ENDM RDAFSC 


C.2.93 RDAFSS Macro 


The RDAFS$S macro generates the code to push a DPB for the READ ALL 
FLAGS directive on the stack followed by an EMT 377. 


Macro call: RDAFSS BUFADR,ERR 


Description: This macro generates the code to push a DPB for the READ 
ALL FLAGS directive on the stack. The DPB arguments must be valid 
assembler source operands and must specify the information described 
in the RDAFS macro. RDAFS$S also generates an EMT 377, using the ERR 
error service address, as described in the DIRS macro. 


»MACRO RDAFSS BA,ERR 
-MCALL MOVS ,DIR$ 
MOVS BA 

MOV (PC)+,-(SP) 
+BYTE: 39 342 

DIRS ,ERR 

»ENDM RDAFSS 


C.2.94 RDAFS Macro 
The RDAFS macro generates a DPB for the READ ALL FLAGS directive. 


Macro call: RDAFS BUFADR 


Description: This macro generates a DPB for the READ ALL FLAGS 
directive. The argument is assumed to have the following meaning: 


BUFADR=Address of four word buffer. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


R.DABA- (length 2 bytes) Buffer address. 


If the macro is invoked with the $$$GLB symbol defined, RDAF$ does not 
generate the DPB and it globally defines the symbolic offset. 


»-MACRO RDAFS BA 
.MCALL OFFS 

-IF NDF $$S$GLB 
-BYTE 39.,2 
-WORD BA 

~ENDC 

.IF NDF R.DABA 
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-NLIST 

OFFS 

OFFS R.DABA,2. 
.LIST 

~ENDC 

-ENDM RDAFS 


C.2.95 RFAS Macro 


RFAS is an internal macro that pushes two words on the stack in 
reverse order from the specified double-word. 


Macro call: RFAS ADR 


Description: RFAS generates the code to push two words on the stack 
in reverse order from the double word with its address specified by 
the source operand's ADR. 


-MACRO RFAS ADR 
-IF NB <ADR> 
-NLIST 

-NTYPE $$$T2,ADR 
-LIST 

-IF LT $$$T2-6 
MOV 2(ADR) ,- (SP) 
MOV (ADR) ,-(SP) 
~IFF 

MOV ADR,-(SP) 
MOV @(SP) ,-(SP) 
ADD #2,2(SP) 

MOV @2(SP) ,2(SP) 
-ENDC 

-IFF 

CLR ~(SP) 

CLR -(SP) 

-ENDC 

-ENDM RFAS 


C.2.96 RQSTS$C Macro 


The ROQSTSC macro generates a DPB for the REQUEST directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RQSTSC TASK,PART,PRI ,UICGC,UICPC,PSCT,ERR 


Description: This macro generates a DPB for the REQUEST directive in 
the $DPBS$ program section. The RQST$ macro describes the DPB 
parameters. RQSTSC then generates an EMT 377 in the program section 
named in PSCT. The DIRS macro describes the ERR error service 
address. The RQSTS macro controls symbolic address generation. 


Note: Read the notice concerning ignored arguments in the RQSTS macro 
below. 


-MACRO ROQSTSC TN,PN,PR,GC,P,CS,ERR 
-MCALL RQSTS ,DIRS 
-IF NDF S$SSGLB 
-PSECT SDPBS$ 
$$S=, 
~IFTP 


MACRO EXPANSIONS 


RQOSTS TN,PN,PR,GC,P 
~lFT 

»-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

»ENDM 


C.2.97 RQSTSS Macro 


The RQOSTSS macro generates the code to push a DPB for the REQUEST 
directive on the stack followed by an EMT 377. 


Macro call: ROQST$S TSKNAMADR,PRTNAMADR,PRI,UICGC,UICPC,ERR 


Description: RQST$S generates the code to push a DPB for the REQUEST 
directive on the stack. The DPB arguments must be valid assembler 
source operands and must specify the information described in the 
RQSTS macro. ROSTSS also generates an EMT 377 using the ERR error 
service address described in DIRS. 


Note: Read the notice concerning ignored arguments in the RQSTS macro 
below. 


.MACRO RQSTSS TN,PN,PR,GC,P,ERR 
.MCALL MVBS ,RFAS ,DIRS$ 

MVB$ P,GC 

CLR -(SP) 

RFAS 

RFAS TN 

MOV (PC) +,-(SP) 

-BYTE 11.,7 

DIRS ,ERR 

.ENDM ROSTSS 


C.2.98 RQSTS Macro 
The RQST$ macro generates a DPB for the REQUEST directive. 
Macro call: RQSTS TASK,PART,PRI,UIGC,UICPC 


Description: This macro generates a DPB for the REQUEST directive. 
The arguments are assumed to have the following meanings: 


TASK=Task name, 
PART=Partition name, 
PRI=Priority, 

UICGC=UIC group code, 
UICPC=UIC programmer code. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.QSTN-(length 4 bytes) Task name, 
R.QSPN-(4) Partition name, 
R.QSPR-(2) Priority, 

R.QSGC-(1) UIC Group, 

R.QSPC-(1) UIC Programmer. 


MACRO EXPANSIONS 


If RQST$ is invoked with the $$SGLB symbol defined, RQST$ does not 
generate the DPB and it globally defines the symbolic offsets. 


Note: RQSTS$ requires the arguments PART and PRI to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, ROQSTS ignores them. 


-MACRO RQSTS TN,PN,PR,GC,P 
-MCALL R50S ,OFFS 

-IF NDF $SSGLB 

-BYTE 11.,7 

R50$ TN 

~WORD 0,0 

«WORD 0 

-BYTE P,GC 

»ENDC 

.IF NDF R.QSTN 

-NLIST 

~IRP X,<,<R.QSTN,4>,<R.QSPN,4>,<R.QSPR,2>,<R.QSPC,1>,<R.QSGC,1>> 
OFFS X 

.ENDM 

.LIST 

.ENDC 

.ENDM ROSTS 


C.2.99 RSUMSC Macro 


The RSUMSC macro generates a DPB for the RESUME directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: RSUMS$SC TASK,PSCT,ERR 


Description: This macro generates a DPB for the RESUME directive in 
the S$DPBS$ program section. The RSUM$ macro describes the DPB 
parameters. This macro then generates an EMT 377 in the program 
section named in PSCT. The ERR error service address is described in 
the DIR$ macro. The RSUM$ macro controls generation of symbolic 
offsets. 


-MACRO RSUMSC TN,CS,ERR 

»MCALL RSUMS ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBS$ 
$$$=., 

~IFTF 

RSUMS TN 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

. ENDC 

-ENDM RSUMSC 


C.2.100 RSUMSS Macro 


The RSUMSS macro generates the code to push a DPB for the RESUME 
directive on the stack and the code for an EMT 377. 


Macro call: RSUMSS TSKNAMADR,ERR 


MACRO EXPANSIONS 


Description: This macro generates the code to push a DPB for the 
RESUME directive on the stack. The DPB arguments must be valid 
assembler source operands, and they must specify the information 
described in the RSUMS macro. This macro also generates an EMT 377 
using the ERR error service address as described in the DIR$ macro. 


».MACRO RSUMSS TN,ERR 
»~MCALL RFAS ,DIRS 
RFAS TN 

MOV (PC)+,-(SP) 
»BYTE 47.,3 

DIRS ,ERR 

~ENDM RSUMSS 


C.2.101 RSUMS Macro 
The RSUMS macro generates a DPB for the RESUME directive. 
Macro call; RSUMS TASK 


Description: This macro generates a DPB for the RESUME directive. 
The argument is assumed to have the following meaning: 


TASK=Task name. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


R.SUTN-(length 4 bytes) Task name. 


If RSUMS is invoked with the $$$GLB symbol defined, © RSUMS does not 
generate the DPB and it globally defines the symbolic offset. 


.MACRO RSUMS$ TN 
.MCALL R50$,OFFS 
.IF NDF SSS$GLB 
-BYTE 47.,3 
R50$ TN 

~ENDC 

.IF NDF R.SUTN 
.NLIST 

OFFS 

OFFS R.SUTN,4 
-LIST 

~ENDC 

.ENDM RSUMS$ 


C.2.102 RONSC Macro 


RUNSC generates a DPB for the RUN directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 


Macro call: RUNSC TSK,PRT,PRI,UGC,UPC,SMG,SNT,RMG,RNT,PSCT,ERR 


Description: RUNSC generates a DPB for the RUN directive in the 
SDPB$$ program section. RUNS describes the DPB parameters. RUNSC 
then generates an EMT 377 in the program section named in PSCT. DIRS 
describes the ERR error service address. The RUN$ macro controls 
symbolic address generation. 


MACRO EXPANSIONS 


Note: Read the discussion notice concerning ignored arguments in the 
RUNS macro below. 


»MACRO RUNSC TN,PN,PR,UG,UP,SM,SU,RM,RU,CS,ERR 
»MCALL RUNS ,DIRS 

~IF NDF SSSGLB 

-PSECT S$DPBS$ 


S$$=. 
-IFTF 
RUNS TN,PN,PR,UG,UP,SM,SU ,RM,RU 
-IFT 
«PSECT CS 
DIRS #$$5,ERR 
. ENDC 
-ENDM RUNSC 


C.2.103 ROUNSS Macro 


RUNSS generates the code tc push a DPB for the RUN directive on _ the 
stack and generates an EMT 377. 


Macro call: RUNSS TNAMADR,PNAMADR,PRI,UGC,UPC,SMG,SNT,RMG,RNT,ERR 


Description: RUNSS generates the code to push a DPB for the RUN 
directive on the stack and generates an EMT 377 using the ERR error 
service address described in DIRS. DPB: arguments must be valid 
assembler source operands and must specify the information described 
in the RUNS macro. 


Note: Read the discussion notice concerning ignored arguments in the 
RUNS macro below. 


-MACRO RUNSS TN,PN,PR,UG,UP,SM,SU,RM,RU,ERR 
-MCALL RVPS ,MVBS ,RFAS ,DIRS 
RVPS SM,SU,RM,RU 

MVBS UP,UG 

CLR -(SP) 

RFAS 

RFAS TN 

MOV (PC)+,-(SP) 

-BYTE 17.,11. 

DIRS ,ERR 

-ENDM RUNSS 


C.2.104 RUNS Macro 

The RUNS macro generates a DPB for the RUN directive. 

Macro call: RUNS TSK,PRT,PRI,UGC,UPC,SMG,SNT,RMG,RNT 
Description: The arguments must have the following meanings: 


TSK=Task name, 

PRT=Partition name, 

PRI=Priority, 

UGC=UIC group code, 

UPC=UIC programmer code, 
SMG=Schedule delta magnitude, 
SNT=Schedule delta unit, 
RMG=Re~schedule interval magnitude, 
RNT=Re-schedule interval unit. 
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The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


R.UNTN-(length 4 bytes) Task name, 
R.UNPN-(4) Partition name, 
R.UNPR-(2) Priority, 

R.UNGC-(1) UIC group, 

R.UNPC-(1) UIC programmer, 
R.UNSM-(2) Schedule magnitude, 
R.UNSU-(2) Schedule unit, 
R.UNRM-(2) Re-schedule magnitude, 
R.UNRU-(2) Re-schedule unit. 


If RUNS is invoked with the $$$GLB symbol defined, RUNS does not 
generate the DPB and RUNS globally defines the symbolic offsets. 


Note: RUNS requires the PRT and PRI arguments to maintain 
compatibility with RSX-11D. Despite the fact that they must be 
specified, RUNS ignores them. 


.MACRO RUNS TN,PN,PR,GC,P,SM,SU,RM,RU 
»MCALL R50$ ,OFFS 
~IF NDF $$$GLB 
.BYTE 17.,11. 
R50$ TN 
.WORD 0,0 
.WORD 0 
~BYTE P,GC 
«WORD SM 
«WORD SU 
~WORD RM 
«WORD RU 
»ENDC 
~IF NDF R.UNTN 
-NLIST 
.IRP X,<,<R.UNTN,4>,<R.UNPN,4>,<R.UNPR,2>,<R.UNPC,1>,<R.UNGC,1>> 
OFFS X 
.ENDM 
,IRP X,<<R.UNSM,2>,<R.UNSU,2>,<R.UNRM,2>,<R.UNRU ,2>> 
OFFS X 
.ENDM 
-LIST 
-ENDC 
~ENDM RUNS 


C.2.105 RVPS Macro 


RVPS is an internal macro that places the parameters passed as an 
argument list into the stack in reverse order. 


Macro call: RVPS Al,A2,...,A10 


Description: RVP$ pushes the elements of the argument list on _ the 
stack in reverse order. RVP$ assumes all elements to be full-word. 
The list is limited to a maximum of ten elements. 


.MACRO RVPS PO,P1,P2,P3,P4,P5,P6,P7,P8,P9 
-MCALL MOVS 

-NLIST 

-NARG $SSARG 

-LIST 


MACRO EXPANSIONS 


-IIF GT SSSARG-9., MOVS <P9> 
~IIF GT SSSARG-8., MOVS <P8> 
-IIF GT SSSARG-7, MOVS <P7> 
~-LIF GT SSSARG-6, MOVS <P6> 
-IIF GT $SSARG-5, MOVS <P5> 
-IIF GT $S$SARG-4, MOVS <P4> 
-IIF GT SSSARG-3, MOVS <P3> 
-LIF GT $$SARG-2, MOVS <P2> 
-IIF GT $SSARG-1, MOVS <Pl> 
-IIF GT S$SSARG, MOVS <PO> 
-ENDM RVPS 


C.2.106 SDATSC Macro 


The SDATSC macro generates a DPB for the SEND DATA directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: SDATSC TASK,BUFADR,EFN,PSCT,ERR 


Description: SDATSC generates a DPB for the SEND DATA directive in 
the SDPBS$ program section and generates an EMT 377 in the program 
section named in PSCT. SDATS describes the DPB parameters and 
controls symbolic address generation. DIRS describes the ERR error 
service address. 


«MACRO SDATSC TN,BA,EFN,CS,ERR 

-MCALL SDATS ,DIRS$ 

IF NDF $$$GLB 

~PSECT $DPBS$$ 
$$$=. 

~IFTF 

SDAT$ TN,BA,EFN 

-IFT 

»-PSECT CS 

DIRS #$$$,ERR 

» ENDC 

-ENDM SDATSC 


C.2.107 SDATSS Macro 


SDATSS generates the code to push a DPB for the SEND DATA directive on 
the stack and generates an EMT 377. 


Macro call: SDAT$S TSKNAMADR,BUFADR,EFN,ERR 


Description: SDATSS generates the code to push a DPB for the SEND 
DATA directive on the stack and generates an EMT 377 using the ERR 
error service address described in DIRS. The DPB arguments must be 
valid assembler source operands and they must specify the information 
described in the SDATS macro. 


»MACRO SDATSS TN,BA,EFN,ERR 
-MCALL MOVS ,RFAS ,DIRS$ 

MOV$ EFN 

MOVS BA 

RFA$ TN 

MOV (PC)+,-(SP) 

-BYTE 71.,5 

DIRS ,ERR 

-ENDM SDATSS 


MACRO EXPANSIONS 


C.2.108 SDATS Macro 
The SDATS macro generates a DPB for the SEND DATA directive. 
Macro call: SDATS TASK,BUFADR,EFN 


Description: This macro generates a DPB for the SEND DATA - directive. 
The arguments are assumed to have the following meanings: 


TASK=Receiver task name, 
BUPADR=Address of thirteen word data buffer, 
EFN=Event flag number. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.DATN-(length 4 bytes) Task name, 
S.DABA-(2) Buffer address, 
S.DAEF-(2) Event flag number. 


If SDATS is invoked with the $S$GLB symbol defined, SDAT$ does not 
generate the DPB and it globally defines the symbolic offsets. 


.MACRO SDATS TN,BA,EFN 
»MCALL R50$,0FFS$ 

-IF NDF $SSGLB 

~_BYTE 71.,5 

R50S TN 

.WORD BA 

.WORD EFN 

.ENDC 

.IF NDF S.DATN 

.NLIST 

.IRP X,<,<S.DATN,4>,<S.DABA,2>,<S.DAEF,2>> 
OFFS X 

-ENDM 

sLIst 

.ENDC 

-ENDM SDATS 


C.2.109 SETFSC Macro 


The SETFSC macro generates a DPB for the SET EVENT FLAG directive in a 
separate PSECT followed by an EMT 377 in the user specified PSECT. 


Macro call: SETFSC EFN,PSCT,ERR 


Description: This macro generates a DPB for the SET EVENT FLAG 
directive in the program section named S$DPBS§$. The SETFS macro 
describes the DPB parameters. The SETFSC macro then generates an EMT 
377. in the program section named in PSCT. The DIR$ macro describes 
the ERR error service address. The SETFS macro controls symbolic 
offset generation. 


»-MACRO SETFSC EFN,CS,ERR 
-MCALL SETFS ,DIRS 
-IF NDF S$SSGLB 
»PSECT SDPBS$ 
$$$=. 
.IFTF 
SETFS EFN 
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IFT 
-PSECT CS 
DIRS #$$$,ERR 
» ENDC 

-ENDM SETFSC 


C.2.110 SETFSS Macro 


SETF$S pushes a DPB for the SET EVENT FLAG directive on the stack and 
generates an EMT 377. 


Macro call: SETFSS EFN,ERR 


Description: SETSF pushes a DPB for the SET EVENT FLAG directive on 
the stack. DPB arguments must be valid assembler operands and specify 
the information described in the SETFS macro. SETSF also generates an 
EMT 377 using the ERR error service address that DIRS describes. 


-MACRO SETFSS EFN,ERR 
-MCALL MOVS ,DIR$ 

MOVS EFN 

MOV (PC)+,-(SP) 

~BYTE 33.,2 

DIRS ,ERR 

-ENDM SETFSS 


C.2.111 SETFS Macro 


The SETF$ macro generates a DPB for the SET EVENT FLAG directive. 


Macro call: SETFS EFN 


Description: This macro generates a DPB for the SET EVENT FLAG 
directive. The argument is assumed to have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.ETEF-(length 2 bytes) Event flag. 


If SETFS is invoked with the S$$$GLB symbol defined, SETFS does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO SETFS EFN 
-MCALL OFFS 
-IF NDF $S$SGLB 
-BYTE 33.,2 
-WORD EFN 

.- ENDC 

-IF NDF S.ETEF 
-NLIST 

OFFS 

OFFS S.ETEF,2 
-LIST 

-ENDC 

-ENDM SETFS 


MACRO EXPANSIONS 


The SFPASC macro generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in a separate PSECT followed by an EMT 377 in 
the user specified PSECT. 


Macro call: SFPASC AST,PSCT,ERR 


Description: SFPA$C generates a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive in the S$DPB$$ program section. SFPAS 
describes the DPB parameters. SFPAS$C then generates an EMT 377 in the 
program section named in PSCT. DIR$ describes the ERR error service 
address. The SFPA$ macro controls symbolic offset generation. 


»MACRO SFPASC AST,CS,ERR 

.MCALL SFPAS,DIRS 

.IF NDF $S$S$GLB 

-PSECT $DPBS$ 
$$$=. 

.IFTF 

SFPAS AST 

.IFT 

.PSECT CS 

DIRS #$$$,ERR 

»ENDC 

-ENDM SFPASC 


C.2.113 SFPASS Macro 


SFPASS generates the code to push a DPB for the SPECIFY FLOATING POINT 
EXCEPTION AST directive on the stack and generates an EMT 377. 


Macro call: SFPASS AST,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY FLOATING POINT EXCEPTION AST directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SFPAS macro. The SFPASS 
macro also generates an EMT 377 using the ERR error service address as 
described in the DIRS macro. 


-MACRO SFPASS AST,ERR 
-MCALL MOVS ,DIRS 

MOVS AST 

MOV (PC)+,-(SP) 

»-BYTE 111.,2 

DIRS ,ERR 

»ENDM SFPASS 


C.2.114 SFPAS Macro 


SFPAS generates a DPB for the SPECIFY FLOATING POINT EXCEPTION AST 
directive. 


Macro call: SFPAS AST 
Description: The argument must have the following meaning: 


AST=AST Service entry address. 


MACRO EXPANSIONS 


The following symbol is locally defined with its assigned values equal 
to the byte offset from the start of the DPB to the DPB element: 


S.FPAE-(length 2 bytes) AST Entry address. 


If SFPAS is invoked with the S$SSGLB symbol defined, SFPAS does not 
generate the DPB and it globally defines the symbolic offsets. 


.MACRO SFPAS AST 
.MCALL OFFS 
-IF NDF $SS$GLB 
-BYTE 111.,2 
-WORD AST 
.ENDC 

.IF NDF S.FPAE 
.NLIST 

OFFS 

OFFS S.FPAE,2 
.LIST 

.ENDC 

.ENDM SFPAS 


C.2.115 SPNDSC Macro 


SPNDSC generates a DPB for the SUSPEND directive in a separate PSECT 
followed by an EMT 377 in the user specified PSECT. 


Macro call: SPNDSC PSCT,ERR 


Description: SPNDSC generates a DPB for the SUSPEND directive in the 
SDPBS$ program section followed by an EMT 377 in the original program 
section named PSCT. DIR$ describes the ERR error service address. 


«MACRO SPNDSC PSCT,ERR 

-MCALL SPNDS ,DIR$ 

.IF NDF $S$SGLB 

-PSECT S$DPBSS$ 
$$$=, 

~IFTF 

SPNDS 

IFT 

-PSECT PSCT 

DIRS #$$$,ERR 

~ENDC 

.ENDM SPNDSC 


C.2.116 SPNDSS Macro 


The SPNDSS macro generates the code to push a DPB for the SUSPEND 
directive on the stack and generates an EMT 377. 


Macro call: SPNDSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the SUSPEND directive on the stack. Then it generates an EMT 377 
using the error service address as described in the DIRS macro. 


-MACRO SPNDSS ERR 
~MCALL DIRS 
MOV (PC)+,-(SP) 
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~-BYTE 45.,1 
DIRS ,ERR 
-ENDM SPNDSS 


C.2.117 SPNDS Macro 
The SPNDS macro generates a DPB for the SUSPEND directive. 
Macro call: SPNDS 


Description: This macro generates a DPB for the SUSPEND directive. 
There are no arguments. 


«MACRO SPND$ 
-IF NDF $$S$GLB 
.BYTE 45.,1 
»ENDC 

.ENDM SPNDS$ 


C.2.118 SPRASC Macro 


The SPARSC macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SPRASC AST,PSCT,ERR 


Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive in the SDPBS$ program section. The SPRA$ macro 
describes the DPB parameters. The SPRASC macro then generates an EMT 
377. in the program section named in PSCT. The DIRS macro describes 
the ERR error service address. The SPRA$ macro controls the 
generation of symbolic offsets. 


.MACRO SPRASC AST,CS,ERR 
.MCALL SPRAS ,DIRS$ 

.IF NDF SS$SGLB 

-PSECT S$DPBS$ 


-PSECT CS 
DIRS #$$$,ERR 
.ENDC 

.ENDM SPRASC 


C.2.119 SPRASS Macro 


The SPRASS macro generates the code to push a DPB for the SPECIFY 
POWER RECOVERY AST directive on the stack and generates an EMT 377. 


Macro call: SPRASS AST,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY POWER RECOVERY AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SPRAS macro. The SPRASS macro also 


MACRO EXPANSIONS 


generates an EMT 377 using the ERR error service address as described 
in the DIRS macro, 


»MACRO SPRASS AST,ERR 
-MCALL MOVS ,DIRS$ 

MOVS AST 

MOV (PC)+,-(SP) 

-BYTE 109.,2 

DIRS ,ERR 

-ENDM SPRASS 


C.2.120 SPRAS Macro 


The SPRAS macro generates a DPB for the SPECIFY POWER RECOVERY AST 
directive. 


Macro call: SPRAS AST 


Description: This macro generates a DPB for the SPECIFY POWER 
RECOVERY AST directive. The argument is assumed to have the following 
meaning: 


AST=AST Service entry address. 


The following symbol is locally defined with is assigned a value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.PRAE-(length 2 bytes) AST entry address. 


If SPRAS is invoked with the $$SGLB symbol defined, SPRA$ does not 
generate the DPB and it globally defines the symbolic offset. 


-MACRO SPRAS AST 
-MCALL OFFS 
-IF NDF S$S$SGLB 
-BYTE 109.,2 
-WORD AST 
»ENDC 

-IF NDF S.PRAE 
-NLIST 

OFFS 

OFFS S.PRAE,2 
~LIST 

-ENDC 

-ENDM SPRAS 


C.2.121 SRDASC Macro 


The SRDASC macro generates a DPB for the SPECIFY RECEIVE DATA AST 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SRDASC AST,PSCT,ERR 


Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive in the $DPBSS program section. The SRDAS macro 
describes the DPB parameters. This macro then generates an EMT 377 in 
the program section named in PSCT. The DIRS macro describes the ERR 
error service address. The SRDAS macro controls symbolic offset 
generation. 


MACRO EXPANSIONS 


.MACRO SRDASC AST,CS,ERR 

»MCALL SRDAS$ ,DIR$ 

.IF NDF S$SSGLB 

»PSECT SDPBS$S$ 
$$$=, 

»IFTF 

SRDAS AST 

IFT 

.PSECT CS 

DIRS #$$$,ERR 

~ENDC 

~ENDM SRDASC 


C.2.122 SRDASS Macro 


SRDA$S macro pushes a DPB for the SPECIFY RECEIVE DATA AST directive 
on the stack and generates an EMT 377. 


Macro call: SRDASS AST,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY RECEIVE DATA AST directive on the stack. The DPB arguments 
must be valid assembler source operands, and they must specify the 
information described in the SRDAS macro. The SRDASS macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. . 


-MACRO SRDASS AST,ERR 
-MCALL MOVS$ ,DIRS$ 

MOV$ AST 

MOV (PC) +,7-(SP) 

-BYTE 107.,2 

DIRS ,ERR 

»ENDM SRDASS 


C.2.123 SRDA$ Macro 
SRDAS generates a DPB for the SPECIFY RECEIVE DATA AST directive. 
Macro call: SRDAS AST 


Description: This macro generates a DPB for the SPECIFY RECEIVE DATA 
AST directive. The argument is assumed to have the following meaning: 


AST=AST service entry address. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


S.RDAE-(length 2 bytes) AST entry address. 


If SRDAS is invoked with the $$$GLB symbol defined, SRDAS does not 
generate the DPB and it globally defines the symbolic offset. 


.MACRO SRDAS AST 
»-MCALL OFFS 

.IF NDF S$S$SGLB 
~BYTE 107.,2 
.WORD AST 

~ENDC 


MACRO EXPANSIONS 


.IF NDF S.RDAE 
-NLIST 

OFFS 

OFFS S.RDAE,2 
.LIST 

»ENDC 

-ENDM SRDAS 


C.2.124 SVDBSC Macro 


SVDBSC generates a DPB for the SPECIFY SST VECTOR TABLE FOR DEBUGGING 
AID directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SVDBSC ADR,LEN,PSCT,ERR 


Description: SVDBSC generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR DEBUGGING AID directive in the S$DPBS$$ program section and 
generates an EMT 377 in the program section named in PSCT. SVDBS$ 
describes the DPB parameters and controls symbolic address generation. 
DIRS describes the ERR error service address. 


-MACRO SVDBSC AD,LN,CS,ERR 

-MCALL SVDBS$ ,DIRS 

-IF NDF $SSGLB 

»-PSECT SDPBS$ 
$$$=. 

-IFTF 

SVDB$ AD,LN 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

.ENDC 

-ENDM SVDBSC 


C.2.125 SVDBSS Macro 


The SVDBSS macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR DEBUGGING AID directive on the stack and generates an 
EMT 377. 


Macro call: SVDBSS ADR,LEN,ERR 


Description: SRDASS macro pushes a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive on the stack. DPB arguments must be 
valid assembler operands and must specify the information described by 
SVDBS. SVDB$S also generates an EMT 377 using the ERR error service 
address described by DIRS. 


-MACRO SVDBSS AD,LN,ERR 
-MCALL MOVS ,DIRS 

MOVS LN 

MOVS AD 

-BYTE 103.,3 

DIRS ,ERR 

.ENDM SVDBSS 
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C.2.126 SVDBS Macro 


The SVDBS macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
DEBUGGING AID directive. 


Macro call: SVDBS$ ADR,LEN 


Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR DEBUGGING AID directive. The arguments are assumed to have 
the following meanings: 


ADR=Address of SST vector table, 
LEN=Length of (number of entries in) table. 


The following symbols are locally defined with their assigned values 
egual to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.VDTA-(length 2 bytes) Table address, 
S.VDTL-(2) Table length. 


If SVDBS is invoked with the $$$GLB symbol defined, SVDB$ does not 
generate the DPB and it globally defines the symbolic offsets. 


.-MACRO SVDBS A,L 
»MCALL OFFS 

.IF NDF S$S$SGLB 
BYTE 103.,3 
-WORD A 

-WORD L 

.ENDC 

.IF NDF S.VDTA 
»NLIST 

.IRP X,<,<S.VDTA,2>,<S.VDTL,2>> 
OFFS X 

.ENDM 

.LIST 

.ENDC 

-ENDM SVDBS 


C.2.127 SVTKSC Macro 


SVTKSC generates a DPB for the SPECIFY SST VECTOR TABLE FOR TASK 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: SVTKSC ADR,LEN,PSCT,ERR 


Description: SVTK$C generates a DPB for the SPECIFY SST VECTOR TABLE 
FOR TASK directive in the $DPB$$ program section and generates an EMT 
377 in the program section named in PSCT. DIR$ describes the ERR 
error service address. The SVTKS macro controls symbolic address 
generation and describes DPB parameters. 


.MACRO SVTKSC ADR,LEN,CS,ERR 
.MCALL SVTKS$ ,DIRS$ 
-IF NDF $$SGLB 
»-PSECT SDPBS$$ 
$$S=, 


SVTK$ ADR,LEN 
-IFT 
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-PSECT CS 
DIRS #$$$,ERR 
-ENDC 

-ENDM SVTKSC 


C.2.128 SVTKSS Macro 


The SVTK$S macro generates the code to push a DPB for the SPECIFY SST 
VECTOR TABLE FOR TASK directive on the stack and generates an EMT 377. 


Macro call: SVTKSS ADR,LEN,ERR 


Description: This macro generates the code to push a DPB for the 
SPECIFY SST VECTOR TABLE FOR TASK directive on the stack. The DPB 
arguments must be valid assembler source operands, and they must 
specify the information described in the SVTK$ macro. This macro also 
generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. 


-MACRO SVTKSS ADR,LEN,ERR 
»MCALL MOVS ,DIRS 

MOVS LEN 

MOVS ADR 

MOV (PC)+,-(SP) 

~-BYTE 105.,3 

DIR$ ,ERR 

-ENDM SVTKSS 


C.2.129 SVTKS Macro 


The SVTK$ macro generates a DPB for the SPECIFY SST VECTOR TABLE FOR 
TASK directive. 


Macro call: SVTKS ADR,LEN 


Description: This macro generates a DPB for the SPECIFY SST VECTOR 
TABLE FOR TASK directive. The arguments are assumed to have the 
following meanings: 


ADR=Address of SST vector table, 
LEN=Length of (number of entries in) table. 


The following symbols are locally defined with their assigned values 
equal to the byte offset from the start of the DPB to the respective 
DPB elements: 


S.VTTA-(length 2 bytes) Table address, 
S.VTTL-(2) Table length. 


If SVTKS is invoked with the $$SGLB symbol defined, SVTKS does not 
generate the DPB and it globally defines the symbolic offsets. 


-MACRO SVTKS TA,TL 
~MCALL OFFS 

-IF NDF S$SSGLB 
-BYTE 105.,3 

~WORD TA 

-WORD TL 

- ENDC 

-IF NDF S.VTTA 
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.NLIST 

.IRP X,<,<S.VTTA,2>,<S.VTTL,2>> 
OFFS X 

.ENDM 

-LIST 

.ENDC 

»ENDM SVTKS 


C.2.130 WSIGSC Macro 


The WSIGSC macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: WSIGSC PSCT,ERR. 


Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive in the $DPB$$ program section followed by an EMT 377 
in the user specified program section that is named PSCT. The DIRS 
macro describes the ERR error service address. 


»MACRO WSIGSC PSCT,ERR 
.MCALL WSIGS ,DIRS 
.IF NDF S$SSSGLB 
~-PSECT SDPBS$S$ 

$$S=. 

~IFTF 

WSIGS 

IFT 

»PSECT PSCT 
DIRS #$$$,ERR 
.ENDC 

.ENDM WSIGSC 


C.2.131 WSIGSS Macro 


The WSIGSS macro generates the code to push a DPB for the WAIT FOR 
SIGNIFICANT event directive on the stack and generates an EMT 377. 


Macro call: WSIGSS ERR 


Description: This macro generates the code to push a one-word DPB for 
the WAIT FOR SIGNIFICANT EVENT directive on the stack. Then it 
generates an EMT 377 using the ERR error service address as described 
in the DIRS macro. 


»~MACRO WSIGSS ERR 
-MCALL DIR$ 

MOV (PC)+,-(SP) 
~BYTE 49.,1 

DIRS ,ERR 

»ENDM WSIGSS 


C.2.132 WSIGS Macro 


The WSIGS$ macro generates a DPB for the WAIT FOR SIGNIFICANT EVENT 
directive. 


MACRO EXPANSIONS 


Macro call: wWSIGS 


Description: This macro generates a DPB for the WAIT FOR SIGNIFICANT 
EVENT directive. There are no arguments. 


-MACRO WSIGS 
-IF NDF $$SGLB 
-BYTE 49.,1 
~ENDC 

-ENDM WSIGS 


C.2.133 WTLOSC Macro 


The WTLOSC Macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. : 


Macro call: WTLOSC SET,MASK,PSCT,ERR 


Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive in the SDPBS$$ program section. The WTLOS 
macro describes the DPB parameters. The WILOSC macro then generates 
an EMT 377 in the program section named in PSCT. The DIR$ macro 
describes the ERR error service address. The WTLOS macro controls 
symbolic offset generation. 


Note: Read the discussion notice concerning ignored arguments in the 
WTLOS macro below. 


-MACRO WTLOSC SET,MASK,CS,ERR 
-MCALL WTLOS ,DIRS 

-IF NDF S$$SGLB 

»PSECT S$DPBSS$ 


$$$=. 
-IFTF 
WILOS SET,<MASK> 
IFT 
.PSECT CS 
DIRS #$$$,ERR 
~ENDC 


~ENDM WTLOSC 


C.2.134 WYTLOSS Macro 


The WILO$SS macro generates the code to push a DPB for the WAIT FOR 
LOGICAL OR OF EVENT FLAGS directive on the stack and generates an EMT 
377. 


Macro call: WTLOSS SET,MASK,ERR 


Description: This macro generates the code to push a DPB for the WAIT 
FOR LOGICAL OR OF EVENT FLAGS directive on the stack. The arguments 
are assumed to have the following meanings: 


SET=Desired set of event flags (0-4) 
MASK=Assembler source operand that yields the desired 
mask word 


The macro also generates an EMT 377, using the ERR error. service 
address as described in the DIRS macro. 
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Note: Read the discussion notice concerning ignored arguments in the 
WTLOS macro below. 


»MACRO WTLOSS SET,MSK,ERR 
.MCALL MOVS ,DIRS$ 
-IF EQ SET-4 
»ERROR SET ;Unsupported macro option; 
~IFF 
MOVS MSK 
-IF NE SET 
MOV #SET,- (SP) 
~IFF 
LR -(SP) 
~ENDC 
MOV (PC) +,- (SP) 
-BYTE 43.,3 
»ENDC 
DIRS ,ERR 
.ENDM WTLOSS 


C.2.135 WTLOS Macro 


The WILOS macro generates a DPB for the WAIT FOR LOGICAL OR OF EVENT 
FLAGS directive. 


Macro call: WTLOS SET,MASK 


Description: This macro generates a DPB for the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive. The arguments are assumed to have the 
following meanings: 


SET=Desired set of event flags (0-4), 
MASK=If set is 0, 1, 2, or 3, a 16-bit (16 flag) mask word; 
If set is 4, a list of four mask words (<M1,M2,M3,M4>). 


WTLO$ does not define any symbolic offsets. WTLOS does not generate 
any code if the $$GLB symbol is defined at the time WTLOS is invoked. 


Note: RSX-11M does not support the specification of flags set number 
4. If flag set number 4 is specified it causes an error. 


-MACRO WTLOS SET,MASK 
.IF NDF $$$GLB 
IF EQ SET-4 


«ERROR SET ;Unsupported macro option 
ober 

-BYTE 43.,3 

»~WORD SET 

-WORD MASK 

»ENDC 

» ENDC 


.ENDM WTLOS 


C.2.136 WTSESC Macro 

The WISESC macro generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive in a separate PSECT followed by an EMT 377 in the user 
specified PSECT. 


Macro call: WTSESC EFN,PSCT,ERR 
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Description: This macro generates a DPB for the WAIT FOR SINGLE EVENT 
FLAG directive in the $DPBS$ section. The WTSES$ macro describes the 
DPB parameters. The WTSESC macro then generates an EMT 377 in the 
program section named in PSCT. The DIRS macro describes the ERR error 
service address. The WTSES macro controls symbolic address 
generation. 


-MACRO WTSESC EF,CS,ERR 

-MCALL WTSES ,DIRS 

-IF NDF $SSGLB 

-PSECT S$DPBSS 
$$$=, 

-IFTF 

WTSES EF 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

~ENDM WTSESC 


C.2.137 WTSESS Macro 


The WISESS macro generates the code to push a DPB for the WAIT FOR 
SINGLE EVENT FLAG directive on the stack and generates an EMT 377. 


Macro call: WTSESS EFN,ERR 


Description: This macro generates the code to push a DPB for the WAIT 
FOR SINGLE EVENT FLAG directive on the stack. The DPB arguments must 
be valid assembler source operands, and they must specify the 
information described in the WTSESS macro. This macro also generates 
an EMT 377, using the ERR error service address as described in the 
DIRS macro. 


-MACRO WTSESS EF,ERR 
~MCALL MOVS ,DIRS 
MOVS EF 

MOV (PC)+,-(SP) 
~-BYTE 41.,2 


DIRS ,ERR 
-ENDM WTSESS 


C.2.138 WYTSES Macro 
WTSES generates a DPB for the WAIT FOR SINGLE EVENT FLAG directive. 
Macro call: WTSES EFN 


Description: WTSES generates a DPB for the WAIT FOR SINGLE EVENT FLAG 
directive. The argument must have the following meaning: 


EFN=Event flag number. 


The following symbol is locally defined with its assigned value equal 
to the byte offset from the start of the DPB to the DPB element: 


W.TSEF-(length 2 bytes) Event flag number. 


If WTSES is invoked with the $SSGLB symbol defined, WTSES does not 
generate the DPB and it globally defines the symbolic offset. 


MACRO EXPANSIONS 


«MACRO WTSES EFN 
-MCALL OFFS 
-IF NDF $$SGLB 
»BYTE 41.,2 
.WORD EFN 
»ENDC 

~IF NDF W.TSEF 
.NLIST 

OFFS 

OFFS W.TSEF,2 
.LIST 

~ENDC 

.ENDM WTSES 


C.3 EXECUTIVE MACRO EXPANSIONS 


The following coded instructions are expansions of macros that you may 
find in the Executive source listings of RSX-11M. 


(C.3.1 CALL Macro 


.MACRO CALL SUBR ARG 
.IF IDN <SINTSV>,<SUBR> 
JSR R5,SINTSV 

~IF DF LS$SIl 

-WORD ARG 

.IFF 

»WORD “~C<ARG>&PR7 

~ENDC 

.IFF 

.IF IDN <SSAVNR>,<SUBR> 
JSR R5,$SSAVNR 

~lFF 

.IF IDN <SSWSTK>,<SUBR> 
EMT 376 

.WORD ARG 

.IFF 

JSR PC,SUBR 

.ENDC 

.ENDC 

~ENDC 

.ENDM 


C.3.2 CALLR Macro 
CALLR is a call and return from subroutine macro. 
»~MACRO CALLR SUBR 


JMP SUBR 
»ENDM 


MACRO EXPANSIONS 


C.3.3 CRASH Macro 
CRASH crashes the system. 


»MACRO CRASH 
IOT 
- ENDM 


C.3.4 DIRSVS Macro 
DIRSV$ is the directive register save and set priority macro. 


«MACRO DIRSVS 
JSR R5,SDIRSV 
»ENDM 


C.3.5 DRSTS Macro 
DRSTS causes a trap to set directive status. 


e-MACRO ODRSTS VALUE 
TRAP VALUE 
- ENDM 


C.3.6 GTUCB$ Macro 


GTUCBS generates code to load the UCB address into R5. It is 
by INTSES and INTSV$ only. 


-MACRO GTUCBS UCBSV,NCTRLR 
-IF NB <UCBSV> 
-IF GT NCTRLR-1 
MOV UCBSV(R4) ,R5 
-IFF 

MOV UCBSV,R5 

- ENDC 

~IFF 

-IF GT NCTRLR-1 
MOV CNTBL(R4) ,R5 
oLFE 

MOV CNTBL,R5 

- ENDC 

- ENDC 

- ENDM 


C.3.7 INTLB Macro 
Generates an interrupt routine entry point label. 


-IF DF ESSDVC 
-MACRO INTLB NUM,NAM 
S'NAM'NUM'T:: 
.ENDM 
-ENDC 


called 
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C.3.8 INTSES Macro 
This is the interrupt save generation macro for error logging devices. 


.MACRO INTSES DEV,PRI,NCTRLR,PSWSV,UCBSV, ?LAB 
.IF DF LSSDRV & LDS'DEV & MSSMGE 
S'DEV'INT:: 
.IF NDF ESSDVC 
.IF EQ NCTRLR-1 
CLR R4 
.ENDC 
»ENDC 
IFF 
~IF NDF ESSDVC 
$'DEV'INT::INTSVS DEV,PRI,NCTRLR,PSWSV,UCBSV 
.IF EQ NCTRLR-1 
CLR R4 
.ENDC 
.MEXIT 
~IFF 
$$$=0 
»REPT NCTRLR 
INTLB \$$$,DEV 
JSR R5,SINTSE 
SCBLB \$$$ ,DEV 
-IF DF LSS$SIl 
»WORD PRI 
.IFF 
»WORD “C<PRI>&PR7 
»ENDC 
.IF GT NCTRLR-S$$$-1 
BR LAB 
~ENDC 
$$S$=S$$$+1 
.ENDR 
LAB: 
~ENDC 
. ENDC 
GTUCBS UCBSV,NCTRLR 
.ENDM 


C.3.9 INTSVS Macro 
INTSVS causes interrupt save generation for non-error logging devices. 


.MACRO INTSVS$ DEV,PRI,NCTRLR,PSWSV,UCBSV 
.IF NDF LSSDRV ! MSSMGE ! LDS$'DEV 
-IF GT NCTRLR-1 

.IF B <PSWSV> 

MFPS TEMP 

-IFF 

MFPS PSWSV 

~ENDC 

.IFTF 

JSR R5S,SINTSV 

.IF DF LS$SI1l 

-WORD PRI 

.IFF 

»WORD “C<PRI>&PR7 

.ENDC 

~IFT 

.IF B <PSWSV> 
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MOV TEMP,R4 

- TIFF 

MOV PSWSV,R4 

-ENDC 

BIC #177760,R4 

ASL R4 

«ENDC 

» ENDC 

GTUCBS UCBSV,NCTRLR 
-ENDM 


C.3.10 MFPS/MTPS Macros 


These macros either read or write processor status. 


-IF NDF LS$$SI1 
-MACRO MFPS DST 
MOVB @#PS,DST 
-ENDM 

»~MACRO MTPS SRC 
-IF IDN <#0>,<SRC> 
CLRB @#PS 

~ IFF 

MOVB SRC,@#PS 

- ENDC 

~ENDM 

~ENDC 


C.3.11 RETURN Macro 
RETURN generates an RTS PC instruction. 


»-MACRO RETURN 
RTS PC 
- ENDM 


C.3.12 SAVNR Macro 


SAVNR causes a jump to a subroutine to save nonvolatile registers. 


»-MACRO SAVNR 
JSR R5,$SAVNR 
~ENDM 


C.3.13 SCBLB Macro 


SCBLB generates a general status control block reference label. 


-IF DF ESS$DVC 

»-MACRO SCBLB NUM,NAM 
«WORD S'NAM'NUM 
-ENDM 

»ENDC 
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C.3.14 SETD Macro 


SETD sets the floating-point processor to double precision mode. 


«MACRO SETD 
«WORD 170011 
» ENDM 


C.3.15 SOB Macro 
SOB generates a decrement loop. 


-IF NDF RSSEIS 
~MACRO SOB A,B 
DEC A 
BNE B 
- ENDM 
- ENDC 


C.3.16 STD Macro 


STD stores a single or double proecision word from the 


processor. 


-MACRO STD A,B 

-NTYPE N,A 

-NTYPE M,B 

«WORD 174000+<N*64 .>+M 
-ENDM 


C.3.17 STFPS Macro 


STFPS stores the floating-point processor's status. 


»~MACRO STFPS A 


eNTYPE N,A 
«WORD 170200+N 
-ENDM 


C.3.18 STST Macro 


STST stores the floating-point exception code 
pointer. 


«MACRO STST A 

~WORD 170337 

eWORD FLSTS 

- ENDM 

-ENDC 

-IIF NDF S$SYDF, .LIST 
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and 


exception 


floating-point 


address 
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C.3.19 SWSTKS Macro 
SWSTKS calls SSWSTK to switch system states. 


»-MACRO SWSTKS ARG 
CALL $SWSTK ,ARG 
-ENDM 

-IF DF FSSLPP 


C.3.20 LDD Macro 
LDD loads double precision floating-point word into the accumulator. 


-MACRO LDD A,B 

-NTYPE N,A 

-NTYPE M,B 

~WORD 172400+<M*64.>+N 
»- ENDM 


C.3.21 LDFPS Macro 
LSFPS loads floating-point status. 


»-MACRO LDFPS A 

-IF IDN <A>,<@H.FPSA(R2) > 
«WORD 170100+72 

-WORD H.FPSA 


Pe 

-NTYPE N,A 
-WORD 170100+N 
. ENDC 

-ENDM 


C.4 FILES-11 HEADER OFFSETS MACRO DEFINITIONS 


C.4.1 FHDOLS Macro 
FHDO1LS defines Files-1l offsets. 


-MACRO FHDOIS OFFSET 
~-MCALL DEFSI,OFFSET,DEFINS 
-IF DF,H.FPRO 

« ERROR 

«ENDC 


Header Area Offsets 


DEFSI 0 

OFFSET H.IDOF,1 ;IDENT area offset in words 

OFFSET H.MPOF,1 ;Map area offset in words 

OFFSET H.FNUM,2 *>File number 

OFFSET H.FSEQ,2 *File sequence number 

OFFSET H.FLEV,2 *Structure level and system number 
OFFSET H.FOWN sOwner of file consisting of: 
OFFSET H,.PROG,1 ; Programmer number 
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OFFSET H.PROJ,1 ; Project number 
OFFSET H.FPRO,2 ; File protection code 


File Protection Bits 


DEFINS FP.RDV,1 sRead access allowed if clear 
DEFINS FP.WRV,2 ;Write access allowed if clear 
DEFINS FP.EXT,4 s;Extend access allowed if clear 
DEFINS FP.DEL,10 Delete allowed if clear 
DEFINS FP.RAT,1 ;Read attributes allowed if clear 
OFFSET H.FCHA ;File characteristics code 
3; consisting of: 
OFFSET H.UCHA,1 ; User controlled characteristics byte 


Bit Definitions for User Controlled Characteristics Byte 


DEFINS UC.CON,200 :File is logically contiguous if set 
DEFINS UC.DLK,100 ;Deaccess lock set if bit is set 
OFFSET H.SCHA,1 +System controlled characteristics 

3; byte 


Bit Definitions for System Controlled Characteristics Byte 


DEFINS SC.MDL,200 ;Marked for delete if set 
DEFINS SC.BAD,100 ;Bad data block in file if set 
OFFSET H.UFAT,32. sUser file attributes 

OFFSET S.HDHD ;Size in bytes of header area 


Ident Area Offsets 


DEFSI 0 
OFFSET I.FNAM,6 ;File name in RAD50 
OFFSET I.FTYP,2 ;File type in RAD50 
OFFSET I.FVER,2 ;File version number in binary 
OFFSET I.RVNO,2 ;Revision number 
OFFSET I.RVDT,7 ;Revision date 
OFFSET I.RVTI,6 ;Revision time 
OFFSET I.CRDT,7 Creation date 
OFFSET I.CRTI,6 ;Creation time 
OFFSET I.EXDT,7 ;Expiration date 
OFFSET ,1 ;Round up to word boundary 
OFFSET S.IDHD ;Size in bytes of IDENT area 
DEFINS 1I.DASZ,7 ;Number of bytes in date string 
DEFINS I.TISZ,6 ;Number of bytes in time string 


C.4.2 FHDOFS Macro 


FHDOFS defines Files-1l1 header offsets. 


FHDOFS ;Define offsets locally 
FHDOFS DEFSL ;Define offsets locally 
FHDOFS DEFSG ;Define offsets globally 


.MACRO FHDOFS GLOBAL 
».MCALL FHDO1S 

.. GBL=0 

.IF B,GLOBAL 

FHDOL$ DEFSL 

.IFF 

.IF IDN,<GLOBAL> ,<DEFS$G> 
..-GBL=1 

»ENDC 

FHDO1S$S GLOBAL 
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~ENDC 

-IF DIF,<GLOBAL> ,<DEFSN> 

«MACRO FHDOFS ARG1 :;Redefine macro 
~ENDM FHDOFS 

~ENDC 

~ENDM FHDOFS 


Map Area Offset 


DEFSI 0 

OFFSET M.ESQN,1 ;Extension sequence number 

OFFSET M.ERVN,1 sExtension relative volume number 
OFFSET M.EFNU,2 ;Extension file number 

OFFSET M.EFSQ,2 ;Extension file sequence number 
OFFSET M.CTSZ,1 ;Block count field size 

OFFSET M.LBSZ,1l ;Logical block number field size 
OFFSET M.USE,1 ;Words in use in the map 

OFFSET M.MAX,1 ;Max number of words available in map 
OFFSET M.RTRV ;Start of retrieval pointers 
OFFSET S.MPHD ;Size in bytes of the map area 


Checksum for File Header 


DEFINS H.CKSM,510. Sum of words 0-255. 
-IF DIF,<OFFSET> ,<DEFSN> 
»-MACRO FHDOLS ARG1 
-ENDM FHDOLS 
»~ ENDC 
»-ENDM FHDOI1S 


C.4.3 HMBOFS And HMBO1S Macros 


HMBOFS and HMBO1S define Files-1l home block offsets. 


HMBOFS ;Define offsets locally 
HMBOFS DEFSL Define offsets locally 
HMBOFS DEF$G ;Define offsets globally 


-MACRO HMBOFS GLOBAL 
.MCALL HMBO1S 

- + -GBL=0 

-IF B,GLOBAL 

HMBOLS DEFSL 

.IFF 

.IF IDN,<GLOBAL> ,<DEFSG> 
..-GBL=1 

-ENDC 

HMBO1S GLOBAL 

-ENDC 

.IF DIF,<GLOBAL> ,<DEFSN> 
-MACRO HMBOFS ARG1 

-ENDM HMBOFS 

-ENDC 

.ENDM HMBOFS 

-MACRO HMBO1S OFFSET 
-MCALL DEFSI,OFFSET,DEFINS 


DEFSI 0 

OFFSET H.IBSZ,2 ;Index bit map size 

OFFSET H.IBLB,4 ;Index bit map LBN 

OFFSET H.FMAX,2 ;Maximum number of files on volume 
OFFSET H.SBCL,2 ;Storage bit map cluster factor 
OFFSET H.DVTY,2 ;Disk device type 

OFFSET H.VLEV,2 ;Structure level 


OFFSET H.VNAM,12. 


OFFSET 


OFFSET H.VOWN,2 
OFFSET H.VPRO,2 
OFFSET H.VCHA,2 


OFFSET H.DFPR,2 


-IF DF 
» ERROR 
- ENDC 

-IF DF 


OFFSET H.VFSQ,2 


»ITFF 
OFFSET 
-ENDC 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
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,H.FPRO 


»RSS11M 


ve 
4 


pede 


H.CHK1,2 
H.VDAT,14. 


4936 


H.INDN,12. 
H,INDO,12. 
H.INDF,12. 


2 


»ENDM HMBOLS$ 


«ENDC 


~ENDM HMBO1S 


~IIF NDF,SSSYDF,.LIST 


J 

H.WISZ,1l 
H.FIEX,1 
H.LRUC,1 


’ 

H.CHK2 ,2 

.IF DIF,<OFFSET> ,<DEFS$N> 
»-MACRO HMBO1S$ ARG1 
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s;Volume name - ASCII 

s RESERVED 

s;Volume owner's UIC 

;Volume protection code 
:Volume characteristics 


New Home Block Information Down to H.FIEX 


:;Default file protection 


:Tried to multiply define H.FPRO 


;Volume file sequence number 
;Updated by dismount 


sNot used 


*sNot used 

;Window size for all files on volume 
*Default file extend in blocks 
sNumber of entries in directory LRU 
sAvailable 

sChecksum of words 0-28. 

sCreation date 

sReserved for relative volume table 
*System independent volume name 
;System independent owner name 
:System independent format type 
sNot used 

sChecksum of words 0-255. 


C.5 FILE CONTROL SERVICES MACRO EXPANSIONS 


Cosek 


BDOFFS generates the buffer descriptor offsets. 


BDOFF$ Macro 


The same type of call 


occurs as for file descriptor offsets. 


»-MACRO BDOFFS OFFSET 
-MCALL OFFSET,DEFSI 


DEFSI 0 
OFFSET 


OFFSET B.VBN,4 


74 


OFFSET B.BBFS,2 


OFFSET B.NXBD,2 


OFFSET 


OFFSET B.BFST,1 


OFFSET 


OFFSET S.BFHD 


rel 


12 


;Virtual block number for this buffer 
s;NUMBER OF bytes read or written 

sPointer to next buffer descriptor 

;Spare byte 

;Buffer status byte 


-IIF IDN,<DEFSN> ,<OFFSET>,.MEXIT 


.MACRO BDOFF$ ARG 
»ENDM BDOFFS 
ENDM BDOFFS 
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C.5.2 CBYTE$ Macro 
CBYTES conditionally assembles a .BYTE directive for VAR at _ the 
specified offset. from the beginning of the FDB. 


»-MACRO CBYTES VAR,OFFSET 


-IF NB,VAR If non null 

oe -PC2=, ;Save PC 

»@...PC1+OFFSET 7;Set PC to specified offset 
~-BYTE VAR ;Assemble the byte 

o=...PC2 ;Restore PC 

»ENDC 


~ENDM CBYTES$ 


C.5.3 CLOSES Macro 
CLOSES closes a file. 


-MACRO CLOSES FDB,ERR 
-MCALL LDFDBS ,ERRS 
LDFDBS FDB 

-GLOBL .CLOSE 

JSR PC,.CLOSE 

ERR$ ERR 

-ENDM CLOSES 


C.5.4 CMOVS2 Macro 


CMOVS$2 conditionally moves two words from VAR to the specified offset 


of RO. 


«MACRO CMOVS2 VAR,OFFSET 
-IIF B,VAR,.MEXIT 


MOV VAR,-(SP) ;Address of 2 words to state 
MOV @(SP) ,OFFSET (RO) :First word to FDB 
ADD #2, (SP) sCalculate address of 2nd word 


MOV @(SP)+,OFFSET+2(RO) ;2nd word to FDB 
-ENDM CMOV$2 


C.5.5 CMOVSB Macro 


CMOVSB conditionally generates a MOVE BYTE instruction to move a 
to the specified offset of RO. 


byte 


-MACRO CMOVSB VAR,OFFSET 

-IF IDN,<#0>,<VAR> 

CLRB OFFSET (RO) 

«MEXIT 

- ENDC 

-IIF NB,VAR, MOVB VAR,OFFSET (RO) 


-ENDM CMOVSB 
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C.5.6 CMOVSW Macro 
CMOVSW conditionally moves a word to the specified offset of RO. 


».MACRO CMOVSW VAR,OFFSET 

.IF IDN,<#0>,<VAR> 

CLR OFFSET (RO) 

.MEXIT 

~ENDC 

,IIF NB,VAR, MOV VAR,OFFSET (RO) 
~ENDM CMOVSW 


C.5.7 CWORDS Macro 


CWORDS conditionally assembles a .WORD directive for VAR at the 
specified offset for the beginning of the FDB. 


MACRO CWORDS VAR,OFFSET 


-LF NB,VAR sIf VAR is not null 

~.-PC2=, s;Save the PC 

o=...PCI+OFFSET *Set the PC to the specified offset 
«WORD VAR sAssemble the word 

o=...PC2 ;Restore the PC 

~ENDC 


».ENDM CWORDS 


C.5.8 DEF$G Macro 
DEFSG defines offsets globally. 


-MACRO DEFSG VAR,SI2Z ;Define global offset 
»MCALL DEFSL 

-LIF NB,VAR,.GLOBL VAR 

DEFSL VAR,SIZ 

-ENDM DEFSG 


C.5.9 DEFSI Macro 


»~MACRO DEFSI IVAL sInitialize definition 
...TPC="O<IVAL> ;Macros program counter 
-ENDM DEFSI 


C.5.10 DEFSL Macro 


.MACRO DEFSL SYM,SIZ 
.IF NB,SYM 
SYM="O<...TPC> 

-ENDC 

.IF NB,SI2Z 

.. TPC=°O<...TPC+SIZ> 
»ENDC 

.ENDM DEFSL 
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C.5.11 DEFSN Macro 
DEFSN updates ...TPC but does not define the symbol. 


»~MACRO DEFSN VAR,SI2Z Define no offset-calculate the size 
»-MCALL DEFSL 

DEFSL ,SIZ 

~ENDM DEFSN 


C.5.12 DEFINS Macro 


DEFINS equates the symbol with its specified value and defines it 
globally if ...GBL = 1. Otherwise, it locally defines the symbol. 


»-MACRO DEFINS SYM,VAL 

-IIF EQ,...GBL-1,.GLOBL SYM 
SYM="Q<VAL> 

-ENDM DEFINS 


C.5.13 DELETS Macro 
DELETS deletes a file. 


-MACRO DELETS FDB,ERR 
-MCALL LDFDB$ ,ERRS 
LDFDB$ FDB 

-GLOBL .DELET 

JSR PC,.DELET 

ERRS ERR 

-ENDM DELETS 


C.5.14 FCSBTS Macro 


FCSBTS defines FCS bits and values locally or globally. Call with 
DEFSG for global definitions; conventionally called with DEFSL for 
local, but anything not equal to DEFSG will do 


- MACRO FCSBT$ GLOBL 
-MCALL DEFINS$ 

-- -GBL=0 

-IIF IDN,<GLOBL> ,<DEFSG>,...GBL=1 


F.RATT bits - Record Attribute Byte 


DEFINS FD.FTN,1 ;FORTRAN carriage control bit 

DEFINS FD.CR,2 s;Insert carriage returns between 
s records 

DEFINS FD.PRN,4 ;R.SEQ/VFC print file 

DEFINS FD.BLK,10 31 if records cannot cross block 


: boundaries 


F.RACC bits - Record Access Byte 


DEFINS FD.RWM,1 On if read/write, off if GET/PUT 

DEFINS FD.RAN,2 7;On if random, off if sequential 

DEFINS FD.PLC,4 :On if partial locate, off if 
;sequential 

DEFINS FD.INS,10 ;On if put sequential insert 


smode; off if truncate mode 
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F,RCTL bits - Record Control Byte - Device Characteristics 


DEFINS FD.REC,1 


DEFINS .D.CCL,2 
device; 


DEFINS FD.TTY,4 
DEFINS FD.DIR,10 


DEFINS FD.SDI,20 
DEFINS$S FD.SQD,40 
DEFINS FD.ISP,2000 
DEFINS FD.OSP,4000 
DEFINS FD.PSE,10000 
DEFINS FD.COM,20000 
DEFINS FD.F11,40000 
DEFINS FD.MNT,100000 


N.STAT Bits - File Name Block Status 


DEFINS NB.VER,1 
DEFINS NB.TYP,2 
DEFINS NB.NAM,4 
DEFINS NB.SVR,10 
DEFINS NB.STP,20 
DEFINS NB.SNM,40 
DEFINS NB.DIR,100 


DEFINS NB.DEV,200 

DEFINS NB.SD1,400 
PPN 

DEFINS NB.SD2,1000 
PPN 


:On if record oriented device, 
soff if block oriented 
:On if carriage control output 


soff if not 

*On if this device is a TTY 

:On if directory device, off if 
snot 

:On if single directory device 
:On if sequential device 

sInput spooling 

;Output spooling 


Word - Set by parse 


sSet if file version was explicit 
*Set if file type was explicit 
*Set if file name was explicit 
*Set if * in version field 

sSet if * in type field 

*Set if * in name field 

*Set if explicit directory 
;pecified 

:Set if device name was explicit 
;Set if * in project number of 


>Set if * in programmer number of 


***k* NOTE: MORE BITS IN N.STAT ARE LOCALLY USED BY FCS 


Check Definition Section in FCS 
F.RTYP Values - Record Type Byte 
Note: These are values, not bits 


DEFINS R.FIX,1 
DEFINS R.VAR,2 
DEFINS R.SEQ,3 


F.FACC Bits - File Access Byte 


DEFINS FA.RD,1 

DEFINS FA.WRT,2 
DEFINS FA.EXT,4 
DEFINS FA.CRE,10 
DEFINS FA.TMP,20 
DEFINS FA.SHR,40 


The following two names apply to the 


;Fixed length records 
*Variable length records 
;Sequenced records 


:Set if read only 

sSet if accessed for write 
;Set if access for extend 

+Set if creating new file 

>Set if creating temp file 
;Set if shared access 


same control bit in F.FACC: 


FA.APD is only used if the file is an existing file 


FA.CRE=0) ; 


FA.NSP is only used if the file is being created 


(FA.CRE=1) 


DEFINS 
DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
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FA.APD,100 ;Set if appending (POSIT to EOF) 

FA.NSP,100 7Set if inhibiting supersede on 
;file creation 

FO.RD,FA.RD ;Open for read 


FO.WRT,FA.WRTIFA.EXT!FA.CRE ;Open for write (create) 
FO.APD,FA.WRT!IFA.EXT!IFA.APD ;Open for append 
FO.MFY,FA.WRT ;Open for modify 


FO.UPD,FA.WRT!FA.EXT ;Open for update 


Bits in F.ACTL 


definitions in 


exclusive. 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


DEFINS 


in the FDB - Several of these bits also have local 
FCSPRE.MAC; however, all definitions are mutually 


FA.ENB,100000 ;Enable use of F.ACTL word 

FA.WCK ,20000 ;Enable write check 

FA.SEQ,40000 ;Enable sequential processing only 

FA.DLK,1000 ;Enable no lock on abnormal close 

FA.RWD ,4000 ;Enable rewind control for magtape 

FA.POS,10000 ;File creation position control for 
;Magtape 

FA.EXC,2000 ;Exclusive use bit 


F.CHR Bits - ACP Global Volume Characteristics 


DEFINS 


CH.AND,1 sANSI 'D' format 


F.MBFG Bits - Multiple Buffering Flag Word - 


DEFINS 


DEFINS 


FD.RAH,1 ;Read ahead if set - this or write 


: behind 
FD.WBH,2 ;Write behind if set - not both 


Note: More bits in F.MBFG used in FCS locally 


-CTRL Function 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
.» MACRO 


Codes 

FF.RWD,1 ; Rewind 

FF.POE,2 ;Position to end of volume (set) 
FF.NV,3 ;Next volume 

FF.SPC,4 © ;Space 

FF.CHR,5 7;Get APC characteristics 
FF.RWF,6 s;ERS rewind file 

FCSBTS ARG 


~-ENDM FCSBTS 
-ENDM FCSBTS 


C.5.15 FCSMC$ 


Macro 


FCSMCS executes an MCALL for all the FCS macros. 


«MACRO 
-MCALL 
-MCALL 
-MCALL 
-MCALL 
-MCALL 
- MACRO 


FCSMCS$ 

OPENSR,OPENSW,OPENSM,OPENSU ,OPENSA,CLOSES 
OPNSSR,OPNSSW,OPNSSM,OPNSSU ,OPNSSA 

READS ,WRITES ,WAITS ,GETS ,PUTS ,DELETS ,FINITS 
FSRSZS$ ,FDBDFS , FDATSA,FDRCSA,FDOPSA,FDBFSA,FDBKSA 
FDATSR,FDRCSR,FDOP$R,FDBFSR,FDBKSR,NMBLKS 

FCSMCS$ 


-ENDM FCSMC$ 
-ENDM FCSMC$ 
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C.5.16 FDATSA Macro 


FDATSA initializes the file attribute section of the FDB at assembly 
time. 


,MACRO FDATSA RTYP,RATT,RSI2,CNTG,ALOC 
.MCALL FDOFFS ,CBYTES ,CWORD$ 

FDOFFS DEFSL 

CBYTES <RTYP>,F.RTYP 

CBYTES <RATT>,F.RATT 

CWORDS <RSIZ>,F.RSIZ 

CWORDS <CNTG>,F.CNTG 

CWORDS <ALOC>,F.ALOC 

~-ENDM FDATSA 


C.5.17 FDATSR Macro 
FDATSR initializes the file attribute section of the FDB at run time. 


.MACRO FDATSR FDB,RTYP,RATT,RSIZ,CNTG ,ALOC 
.MCALL LDFDBS ,CMOV$W,CMOVSB 

LDFDBS FDB ;Load FDB address 
CMOVSB RTYP,F.RTYP 

CMOVSB RATT,F.RATT 

CMOVSW RSIZ,F.RSIZ 

CMOVSW CNTG,F.CNTG 

CMOVSW ALOC,F.ALOC 

.ENDM FDATSR 


c.5.18 FDBDFS Macro 
FDBDF$ allocates space at assembly time for the FDB. 


.MACRO FDBDFS 
.MCALL FDBS2ZS$ 
FDBSZ$ 
..-PCl1=. 
.BLKB S.FDB 
»ENDM FDBDFS 


cC.5.19 FDBFSA Macro 


FDBFSA intializes the buffer descriptor section of the FDB at assembly 
time. 


.MACRO FDBFSA EFN,OVBS ,MBCT ,MBFG 
.MCALL FDOFFS ,CBYTE$ ,CWORD$ 
FDOFF$ DEFSL 

CBYTES <EFN>,F.EFN 

CWORDS <OVBS>,F.OVBS 

CBYTES <MBCT>,F.MBCT 

CBYTES <MBFG>,F.MBFG 

»-ENDM FDBFSA 
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C.5.20 FDBFSR Macro 
FDBFSR initializes the block buffer section of the FDB at run time. 


+MACRO FDBFSR FDB,EFN,OVBS ,MBCT,MBFG 
MCALL LDFDB$ ,CMOVSW,CMOVSB 


LDFDB$ FDB 

CMOVSB EFN,F.EFN ;Event flag to use 

CMOVSW OVBS,F.OVBS :Size of block buffer 
CMOVSB MBCT,F.MBCT *No. of buffers 

CMOVSB MBFG,F.MBFG ;Read ahead or write behind 


-ENDM FDBFSR 


C.5.21 FDBKSA Macro 


FDBKSA initializes the block access section of the FDB at assembly 
time. 


-MACRO FDBKSA BKAD,BKSZ,BKVB,BKEF,BKST,BKDN 

»MCALL FDOFFS ,CBYTES ,CWORDS 

FDOFFS DEFSL 

CWORDS <BKAD>,F.BKDS+2 

CWORDS <BKSZ>,F.BKDS 

CWORDS <BKVB>,F.BKVB+2 :Store low order only 
CBYTES <BKEF>,F.BKEF 

CWORDS <BKST>,F.BKST 

CWORDS <BKDN>,F.BKDN 

-ENDM FDBKSA 


C.5.22 FDBKSR Macro 
FDBKSR initializes the block access section of the FDB at run time. 


»MACRO FDBKSR FDB,BKAD,BKS2,BKVB,BKEF,BKST,BKDN 
-MCALL LDFDBS ,CMOVSB,CMOVSW,CMOVS$2 


LDFDBS FDB 

CMOVSW BKAD,F.BKDS+2 ;Block address-memory buffer 

CMOVSW BKSZ,F.BKDS ;Size of transfer in bytes 

CMOVS2 BKVB,F.BKVB ;Address of 2 word virtual 
;Block number, move both words 

CMOVSB BKEF,F.BKEF :Event flag 

CMOVSW BKST,F.BKST ;ADR OF I/O STATUS BLOCK 

CMOVSW BKDN,F.BKDN ;Address of I/O done AST 


-ENDM FDBKSR 


C.5.23 FDBSZ$ Macro 
FDBSZ$ defines the size of the FDB as a local symbol (S.FDB). 


»-MACRO FDBS2Z$ ;Define S.FDB as size of FDB 
~LIF DF,S.FDB, .MEXIT 
»-MCALL FDOFFS ,DEFSL 

FDOFFS DEFSN Invoke offset definitions but do 
not actually define che offset 
names 

Now define S.FDB 


=e ~O NO NO 


DEFSL S.FDB 
~-ENDM FDBS2$ 


C.5.24 FDOPSA 


MACRO EXPANSIONS 


Macro 


FDOPSA initializes the file open section of the FDB at assembly time. 


«MACRO 
.MCALL 
FDOFFS 
CBYTES 
CWORDS 
CWORDS 
CBYTES 
CWORDS 


FDOPSA LUN,FNPT,DFNB,FACC,FACTRL 
FDOFFS ,CBYTES , CWORDS 

DEFSL 

<LUN>,F.LUN 

<FNPT> ,F.DSPT 

<DFNB> ,F.DFNB 

<FACC>,F.FACC 

<FACTRL> ,F.ACTL 


-ENDM FDOPSA 


C.5.25 FDOPS$R 


Macro 


FDOPSR initializes the file open section of the FDB at run time. 


.» MACRO 
.MCALL 
LDFDB$ 
CMOVSB 
CMOVSW 
CMOVSW 
CMOVSB 
CMOVSW 


FDOPSR FDB,LUN,FNPT,DFNB,FACC,FACTRL 
LDFDBS ,CMOVSW,CMOVSB 

FDB 

LUN,F.LUN 

FNPT,F.DSPT 

DFNB,F.DFNB 

FACC,F.FACC 

FACTRL,F.ACTL 


-ENDM FDOPS$R 


C.5.26 EFDRCSA 


Macro 


FDRCSA initializes the record access section of the FDB 


time. 


. MACRO 
»MCALL 
FDOFFS 
CBYTES$ 
CWORDS 
CWORD$ 


FDRCSA RACC,URBA,URBS 
FDOFFS ,CBYTES ,CWORD$ 
DEFSL 

<RACC>,F.RACC 
<URBA> ,F .URBD+2 
<URBS> ,F.URBD 


~-ENDM FDRCSA 


C.5.27 FDRCSR Macro 


at 


assembly 


FDRCSR initializes the record access section of the FDB at run time. 


»MACRO FDRCSR FDB,RACC,URBA,URBS 
.MCALL LDFDBS ,CMOVSW,CMOVSB 
LDFDBS FDB 

CMOV$B RACC,F.RACC 

C...VSW URBA,F.URBDt+2 

CMOVSW URBS,F.URBD 


-ENDM 


FDRCSR 


C.5.28 FDOFSL 


Macro 


MACRO EXPANSIONS 


FDOFSL calls FDOFFS to locally define offsets. This action occurs 


only once. 


.MACRO 
.MCALL 
FDOFFS 


FDOFSL 
FDOFFS 
DEFSL 


-ENDM FDOFSL 


C.5.29 FDOFFS 


Macro 


FDOFF$ is the File Descriptor Block definition macro. It is called 
with one of the following macro names: DEFSL, DEFSG, or DEFSN. DEFSL 
defines local offsets, DEFSG defines total offsets, and DEFSN defines 
the size of the FDB. 


-MACRO FDOFFS OFFSET 


~MCALL OFFSET,DEFSI ,NBOFFS 


NBOFFS 


DEFSI 0 


File Attribute 


OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 


OFFSET 


Section 


F.RTYP,1 
F.RATT,1 
F.RSIZ,2 
F.HIBK,4 
F.EFBK,4 
F.FFBY,2 
S.FATT 


Record Access Section 


OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 
OFFSET 


F.RACC,1 
F.RCTL,1 
F.BKDS 
F.URBD,4 
F.BKST 
F.NRBD,2 
F.BKDN 
,2 
F.OVBS 
F.NREC ,2 
F.EOBB,2 
F.CNTG 
F.RCNM,2 
F.STBK 
,2 
F.ALOC,2 


File Open Section 


OFFSET 
OFFSET 
OFFSET 
OFFSET 


F.LUN,1 

F.FACC,1 
F.DSPT,2 
F.DFNB,2 


sInitialize the definition macro 


;Record type 

;Record attributes 

;Record size 

;Highest virtual block no. allocated 
s;End of file block number 

;First free byte in last block 

:Size of file attribute section 


,Record access 

;Record control 

7;Block I/O - buffer descriptor 
;User's record buffer descriptor 
:Block I/O - I/O status block address 
;Next record buffer descriptor 
;Block I/O = I/O done AST address 
32nd word of NRBD 

;Override block buffer size 

;Next record address in block buffer 
s;End of block buffer 

;Size in blocks of contiguous file 
Record number for random records 
sAddress to read in statistics block 
72nd word of RCNM 

Allocate this much space when need 
;To extend, + = contig, - = not 


;Logical unit number 

;File access 

;File descriptor pointer 
;Default file name block address 


Block Buffer Se 


ction 


MACRO EXPANSIONS 


OFFSET F.BKEF sBlock I/O - event flag number 
OFFSET F.EFN,1 sEvent flag used in QIO 
OFFSET F.BKP1,1 ;Bookkeeping bits 
OFFSET F.ERR,2 1st byte error return code 
2nd byte for QIO error indicator 
OFFSET F.MBCT,1 sNumber of buffers to use (desired) 
OFFSET F.MBC1,1 *Number of buffers in use 
OFFSET F.MBFG,1 sMultiple buffering control flags 
OFFSET F.BGBC,1 ;Big buffer block count (size in 
: blocks) 
OFFSET F.VBSZ,2 ;Virtual block size in bytes 
OFFSET F.BBFS,2 *Block buffer size 
OFFSET F.BKVB *Block I/O - virtual block number 
OFFSET F.VBN,4 :Virtual block number 
OFFSET F.BDB,2 *Block buffer descriptor block 
OFFSET F.SPDV,2 +Spool device indicator 
OFFSET F.SPUN,1 ;Spool unit designator 
OFFSET F.CHR,1l sACP volume characteristics summary 
; byte 
OFFSET F.ACTL,2 sAccess control word 
OFFSET F.SEQN,2 >Sequence number for sequenced files 


File Name Block Section 


OFFSET F.FNB,S.FNB :Beginning of file name block 
,IIF IDN,<OFFSET>,<DEFSN>,.MEXIT 

~LF IDN, <OFFSET> , <DEF$G> 

.GLOBL F.FNAM,F.FTYP,F.FVER,F.DVNM,F.UNIT 

»ENDC 
F.FNAM=N.FNAM+F.FNB 
F.FTYP=N.FTYP+F.FNB 
F.FVER=N.FVER+F.FNB 
F.DVNM=N .DVNM+F.FNB 
F.UNIT=N.UNIT+F.FNB 
OFFSET S.FDB 

-MACRO FDOFF$ ARG 
-ENDM FDOFF$ 

.ENDM FDOFFS 


;Size of FDB 


C.5.30 FDSOFS$S Macro 


FDSOF$ defines offsets relative to the file descriptor pointer, 
F.DSPT. 


».MACRO FDSOFS OFFSET 
.MCALL OFFSET,DEFS$I,DEF$L 
DEFSI 0 

OFFSET N.DEVD,4 
OFFSET N.DIRD,4 
OFFSET N.FNMD,4 
OFFSET S.FIDS 
.IF IDN,<DEFSN> ,<OFFSET> 
DEFSL S.FIDS 

.MEXIT 

.»ENDC 

.MACRO FDSOF$ ARG 

.ENDM FDSOFS 

~ENDM FDSOFS 


sDevice string descriptor 
*Directory string descriptor 
;File name string descriptor 


MACRO EXPANSIONS 


C.5.31 FINITS and FSRSZ$ Macros 
FINITS and FSRSZS initialize the file control services. 


»MACRO FINITS 

-GLOBL .FINIT 

JSR PC,.FINIT 

-ENDM FINITS 

»MACRO FSRSZS NFILES,BFSPAC,PSECT 
-MCALL BDOFFS ,DEFSL 

-IF NDF,S.BFHD 

BDOFFS DEFSN 

DEFSL S.BFHD 

»ENDC 

-GLOBL .FSRCB 

-PSECT $$FSR1,GBL,OVR,D 

-IF NB,<BFSPAC> 

-BLKB NFILES*S.BFHD+<BFSPAC> 
-IFF 

~-BLKB NFILES*<S.BFHD+512.> 
-ENDC 

»PSECT PSECT 

-ENDM FSRS2$ 


C.5.32 FSROF$ Macro 
FSROFS generates the file storage region offsets. 


-MACRO FSROFS OFFSET 
»MCALL OFFSET,DEFSI,DEFSL 


Define the Offsets for SSFSR2 


DEFSI 0 

OFFSET ,4 s;List head for allocation 
OFFSET A.BFSR,2 :First address in FSRI1 
OFFSET A.EFSR,2 ;Last address in FSRI] 


kkk DO NOT SEPARATE THE FOLLOWING 2 DEFINITIONS 

OFFSET A.OWUI,2;UIC of owner (from task header) 

OFFSET A.FIPR,2 ;Default file protection word 
*xkkk DO NOT SEPARATE THE PRECEEDING 2 DEFINITIONS 


x***k* DO NOT SEPARATE THE FOLLOWING 3 DEFINTIONS 


OFFSET A.DPB,24. :Q1/0 DPB and scratch area 

OFFSET A.IOST,4 ;Scratch I/O status block 

OFFSET A.DFDR,24. *Default directory information 

kekek*k DO NOT SEPARATE THE PRECEEDING 3 DEFINITIONS 

OFFSET A.DFBC,2 :;Default buffer count (multiple 
;buffering) 

OFFSET A.DFUI,2 ;Default UIC (task UIC) 

OFFSET S.FSR2 Size of file storage region 2 


DEFSL S.FSR2 


Define Offsets Relative to Beginning of the Default Directory Info 


DEFSI 0 

OFFSET ,14. 

OFFSET D.DFID,6 ;Default directory ID 
OFFSET D.DFDV,2 Device name for default 


;directory ID 


MACRO EXPANSIONS 


OFFSET D.DFUN,2 ;Unit number for default 
s;directory ID 

-ILIF IDN,<DEFSN>,<OFFSET>,.MEXIT 

»-MACRO FSROFS ARG 

~-ENDM FSROFS 

eENDM FSROFS 


C.5.33 GETS Macro 
GETS gets a record from a file. 


»-MACRO GETS FDB,INADR,MAXCNT,ERR 
»MCALL LDFDBS ,CMOVSW,ERRS 


LDFDBS FDB 
CMOVSW INADR,F.URBD+2 *User record buffer address 
CMOVSW MAXCNT,F.URBD s;User record buffer size 


.GLOBL .GET 
JSR PC,.GET 
ERRS$ ERR 
.ENDM GETS 


C.5.34 GETSR Macro 
GETSR gets a record in random mode. 


»-MACRO GETSR FDB,INADR,MAXCNT,LRCNM,HRCNM,ERR 
.MCALL’ LDFDBS$ ,CMOVSW,ERRS 


LDFDBS FDB 

CMOVSW INADR,F.URBD+2 sUser record buffer address 
CMOVSW MAXCNT,F.URBD User record buffer size 
CMOVSW LRCNM,F.RCNM+2 ;Low order record number 
CMOVSW HRCNM,F.RCNM ;High order record number 
~GLOBL .GET 

JSR PC,.GET 

ERRS ERR 


~ENDM GETSR 


C.5.35 GET$S Macro 
GETSS gets a record in strictly sequential mode. 


-MACRO GETSS FDB,INADR,MAXCNT,ERR 
-MCALL LDFDBS$ ,CMOVSW,ERR$ 


LDFDB$ FDB 
CMOVSW INADR,F.URBD+2 ;User record buffer address 
CMOVSW MAXCNT,F.URBD ;User record buffer size 


.GLOBL .GETSQ 
JSR PC,.GETSQ 
ERRS$ ERR 
~ENDM GETSS 


c.5.36 NBOFSL Macro 


NBOFSL calls NBOFFS to define offsets as local symbols. This action 
occurs only once. 


MACRO EXPANSIONS 


»-MACRO NBOFSL 
-MCALL NBOFFS 
NBOFFS DEFSL 
-ENDM NBOFSL 


If the FDB parameter is null or RO, LDFDBS does not move FDB to RO. 
Otherwise, it does move the FDB to RO. 


»~MACRO LDFDBS FDB 

LIF B,FDB,.MEXIT :I£ null then exit 
-NTYPE PARSSS,FDB 

e-LIF EQ,PARSSS,.MEXIT ;If RO then exit 

MOV FDB,RO ;Else generate the move 
-ENDM LDFDBS 


C.5.37 NBOFFS$ Macro 
NBOFFS generates the file name block offsets. 


-MACRO NBOFFS OFFSET 
-MCALL OFFSET,DEFSI,DEFSL 


DEFSI 0 
OFFSET S.FNAM ;Define as global if parameter 
OFFSET S.FTYP ;Is DEFSG 


OFFSET S.FNTY 
OFFSET S.FNBW 


S.FNAM=6 :;Size of filename in bytes 
S.FTYP=2 ;Size of file type in bytes 
S.FNTY=<S.FNAM+S.FTYP>/2 ;Size of filename + type in words 
OFFSET N.FID,6 3;File ID 

OFFSET N.FNAM,S.FNAM ;Filename 

OFFSET N.FTYP,S.FTYP ;Type 

OFFSET N.FVER,2 :Version 

OFFSET S.NFEN ;Size of name file entry in bytes 
DEFSL S.NFEN sForce at least a local definition 
OFFSET N.STAT,2 ;Status 

OFFSET N.NEXT,2 :Temp cell for find next 

OFFSET N.DID,6 ;Directory ID 

OFFSET N.DVNM,2 ;Device name in ASCII 

OFFSET N.UNIT,2 ;Unit number 

OFFSET S.FNB 7;Size of FNB in bytes 

DEFSL S.FNB ;Force local definition at least 
S.FNBW=S.FNB/2 7;Size of FNB in words 


~IIF IDN,<DEFSN>,<OFFSET>,.MEXIT ;Don't redefine the macro 
»~MACRO NBOFFS ARG 

-ENDM NBOFFS 

-ENDM NBOFFS 


C.5.38 NMBLKS Macro 
NMBLKS defines the file name block at assembly time. 


»-MACRO NMBLKS FNAME,FTYPE,VERS ,DEVNAM,UNIT 
-MCALL RAD50$ ,CWORDS ,NBOFFS 


NBOFFS DEFSL ;Define name block offsets locally 
-IIF NDF,...PC1l,...PC1=0 

# tv PC3= ee4.PCl ;Preserve ...PCl 

sae PCl=, 


o=. e ~PC1+N.FNAM 
RADSOS$ <FNAME>,S.FNAM/2 


MACRO EXPANSIONS 


-=...PCI+N.FTYP 

RADS50$ <FTYPE>,S.FTYP/2 
CWORDS <VERS>,N.FVER 
.IF NB,DEVNAM 
.=...PCL+N.DVNM 

-WORD "DEVNAM 

~ENDC 

C,ORD$ <UNIT>,N.UNIT 
.=...PC1+S.FNB 
~--PC1l=...PC3 :;Restore ...PCl 
.ENDM NMBLKS$ 


C.5.39 OPENS Macro 
OPENS opens a file. 


.MACRO OPENS FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 
.MCALL FDOPSR,FDRCSR,ERRS ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

.GLOBL .OPEN 

JSR PC,.OPEN 

ERRS ERR 

~ENDM OPENS 


C.5.40 OPENSA Macro 
OPENSA opens a file for appending. 


.MACRO OPENSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 
OPENS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OPENSA 


C.5.41 OPENSM Macro 
OPENSM opens a file for modification. 


.MACRO OPENSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 
OPENS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSM 


C.5.42 OPENSR Macro 
OPENSR opens a file for reading. 


.MACRO OPENSR, FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
.MCALL OPENS 
OPENS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSR 


MACRO EXPANSIONS 


C.5.43 OPENSU Macro 
OPENSU opens a file for updating. 


~-MACRO OPENSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 
OPENS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSU 


C.5.44 OPENSW Macro 
OPENSW opens a file for writing. 


.MACRO OPENSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 

OPENS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPENSW 


C.5.45 OPNSSA Macro 
OPNSSA opens a shared file for appending. 


»MACRO OPNSSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSA 


C.5.46 OPNSSM Macro 
OPNSSM opens a shared file for modification. 


-MACRO OPNSSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!IFO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSM 


C.5.47 OPNSSR Macro 
OPNSSR opens a shared file for reading. 


-MACRO OPNSSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNS5R 


C.5.48 OPNS$U Macro 
OPNSSU opens a shared file for updating. 


.MACRO OPNSSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

.-MCALL OPENS 

OPENS FDB,#FA.SHR!FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSU 


MACRO EXPANSIONS 


C.5.49 OPNSSW Macro 
OPNSSW opens a shared file for writing. 


»-MACRO OPNSSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPENS 


OPENS FDB,#FA.SHR!FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OPNSSW 


C.5.50 OPNTSD Macro 


Create, access, and mark for delete a new file not entered in a 
directory. It will be deleted when closed (deaccessed) and will be 
properly deleted if program should terminate abnormally. 


.MACRO OPNTSD FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OPNTSW 

OPNTSW FDB,LUN,FNPT,RACC,URBA,URBS 

BCS .+6 

JSR PC,.MRKDL 

ERRS$ ERR 

~ENDM OPNTSD 


C.5.51 OPNTSW Macro 


OPNTSW creates and accesses a new file and does enter it in a 
directory. The file may be closed and reopened by file ID. The file 
should be deleted before the program exits otherwise it remains in the 
index file with no directory entry. 


.MACRO OPNTSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

.MCALL OPENS 

OPENS FDB,#FA.TMP!FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OPNTSW 


C.5.52 OFIDS Macro 
OFIDS opens a file by file ID. 


«MACRO OFIDS FDB,FACC,LUN,FNPT,DFNB,RACC,URBA,URBS,ERR 
-MCALL FDOPS$R,FDRCSR,ERR$ ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .OPFID 

JSR PC,.OPFID 

ERRS ERR 

-ENDM OFIDS 


C.5.53 OFIDSA Macro 
OFIDSA opens a file by file ID for appending. 


»MACRO OFIDSA FDB,LUN,FNPT,RACC ,URBA,URBS,ERR 
-MCALL OFIDS 
OFIDS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSA 


MACRO EXPANSIONS 


C.5.54 OFIDSM Macro 
OFIDSM opens a file for modification by file ID. 


-MACRO OFIDSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 


OFIDS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSM 


C.5.55 OFIDSR Macro 
OFIDSR opens a file for reading by file ID. 


»-MACRO OFIDSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»-MCALL OFIDS 
OFIDS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
~-ENDM OFIDSR 


C.5.56 OFIDSU Macro 
OFIDSU opens a file for updating by file ID. 


»MACRO OFIDSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 
OFIDS$ FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSU 


C.5.57 OFIDSW Macro 
OFIDSW opens a file for writing by file ID. 


»-MACRO OFIDSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFIDS 
OFIDS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFIDSW 


C.5.58 OFNBS Macro 
OFNBS opens a file by file name block. 


.MACRO OFNBS FDB,FACC,LUN,FNPT,DFNB, RACC,URBA,URBS,ERR 
-MCALL FDOPSR,FDRCSR,ERRS ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .OPFNB 

JSR PC,.OPFNB 

ERRS ERR 

-ENDM OFNBS 


MACRO EXPANSIONS 


C.5.59 OFNBSA Macro 

OFNBSA opens a file by file name block for appending. 
.MACRO OFNBSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»MCALL OFNBS$ 


OFNBS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSA 


c.5.60 OFNBSM Macro 

OFNBSM opens a file by file name block for modification. 
.MACRO OFNBSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFNBS 


OFNBS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
»ENDM OFNBSM 


C.5.61 OFNBSR Macro 

OFNBSR opens a file by file name block for reading. 
.MACRO OFNBSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFNBS Memes ht 


OFNBS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
.ENDM OFNBSR 


C.5.62 OFNBSU Macro 

OFNBSU opens a file by file name block for updating. 
.MACRO OFNBSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL OFNBS 


OFNBS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM OFNBSU 


C.5.63 OFNBSW Macro 

OFNBSW opens a file by file name block for writing. 
» MACRO OFNBSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
.MCALL OFNBS 


OFNBS FDB,#FO.WRT,LUN,FNPT, ,RACC,URBA,URBS,ERR 
-ENDM OFNBSW 


C.5.64 PUTS Macro 
PUTS puts a record in random or sequential mode. 


.MACRO PUTS FDB,OUTADR,OUTCNT,ERR 
.MCALL LDFDBS ,CMOV$W,ERRS$ 


LDFDBS FDB 
CMOVSW OUTADR,F.NRBD+2 ;Next record buffer address 
CMOVSW OUTCNT,F.NRBD ;Next record buffer size 


-GLOBL 


MACRO EXPANSIONS 


-PUT 


JSR PC,.PUT 
ERRS ERR 
-ENDM PUTS 


POUTSR Macro 


PUTSR puts a record in random mode. 


»-MACRO PUTSR FDB,OUTADR,OUTCNT,LRCNM,HRCNM,ERR 
»-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDBS FDB 

CMOVSW OUTADR,F.NRBD+2 ;Next record buffer address 
CMOVSW OUTCNT,F.NRBD ;Next record buffer size 
CMOVSW LRCNM,F.RCNM+2 3;Low order record number 
CMOVSW HRCNM,F.RCNM ;High order record number 
»~GLOBL .PUT 


JSR PC,.PUT 
ERR$ ERR 
-ENDM PUTSR 


PUTSS Macro 


PUTSS puts a record in strictly sequential mode. 


»-MACRO PUTSS FDB,OUTADR,OUTCNT,ERR 

-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDBS FDB 

CMOVSW OUTADR,F.NRBD+2 ;Next record buffer address 
CMOVSW OUTCNT,F.NRBD s;Next record buffer size 
-GLOBL .PUTSQ 

JSR PC,.PUTSQ 

ERRS ERR 


-ENDM PUTSS 


C.5.67 RADSOS Macro 

»-MACRO RAD50$ STRING ,MAXWRD 

oe ePC2=. 

»~RAD5O /STRING/ 

~IF GT,<.-...PC2>-"0<2*MAXWRD> 


» ERROR ;String RAD50 - string too long, 
; truncated 

~="O<...PC2+<2*MAXWRD>> 

«MEXIT 

«~ENDC 

~REPT “O<MAXWRD-<<.-...PC2>/2>> 

»WORD 0 

«~ENDR 


-ENDM RAD50$ 


C.5.68 


MACRO EXPANSIONS 


READS Macro 


READS reads a virtual block. 


C.5.69 


.MACRO READS FDB,BKAD,BKSZ,BKVB,BKEF,BKST,BKDN,ERR 


.MCALL FDBKSR,ERRS 

FDBKSR FDB,BKAD,BKSZ,BKVB,BKEF ,BKST,BKDN 
.GLOBL .READ 

JSR PC,.READ 

ERR$ ERR 

~ENDM READS 


TRUNCS Macro 


TRUNCS truncates a file. 


.MACRO TRUNCS FDB,ERR 
»MCALL LDFDBS ,ERRS 
LDFDBS FDB 

-GLOBL .TRUNC 

JSR PC,.TRUNC 

ERRS$ ERR 

»ENDM TRUNCS 


C.5.70 WAITS Macro 


WAITS 


waits for I/O completion after a READS 


execution. 


.MACRO WAITS FDB,EFN,BKST,ERR 
.MCALL LDFDBS ,CMOVSW,CMOVSB,ERRS$ 
LDFDB$ FDB 

CMOVSB EFN,F.EFN 

CMOVSW BKST,F.BKST 

.GLOBL .WAIT 

JSR PC,.WAIT 

ERRS ERR 

~ENDM WAITS 


C.5.71 WRITES Macro 


WRITES writes a virtual block. 


or WRITES 


.MACRO WRITES FDB,BKAD,BKSZ,BKVB,BKEF ,BKST,BKDN,ERR 


.MCALL FDBK$R,ERRS 

FDBK$R FDB,BKAD,BKSZ,BKVB,BKEF,BKST,BKDN 
.GLOBL .WRITE 

JSR PC,.WRITE 

ERRS ERR 

»ENDM WRITES 


macro 


MACRO EXPANSIONS 


C.6 NETWORK SYMBOL DEFINITION MACRO 


C.6.1 COMDFS Macro 
Commom Symbol Module for M/D Networks Implementation 


»MACRO COMDFS DEF 

-NLIST 

-IF IDN <DEF>,<DEFSG> 

-GLOBL B.OT,B.UN,B.RC,B.RN,B.RP,B.RU,B.NA,B.UA,B.MN,B.MX 

-GLOBL CT.IN,CT.CN,LB.N,LB.E 

-GLOBL NT.IN,NT.NS 

-GLOBL CR.UR,CR.NR,CR.MX 

-GLOBL CR.NO,CR.N1,CR.N2,CR.N3,CR.N4,CR.N5,CR.N6,CR.NO, 
CR.N1O,CR.N11 

-GLOBL CR.N7,CR.N8 

-GLOBL CR.DI,CR.DT,CR.DA 

~GLOBL IA.ISM,IA.ABO,IA.DIS,IA.NFW 

-GLOBL CN.IN,CN.OU,CN.UT,CN.NT 

-GLOBL OB.TA,OB.FS,0B.SQ,0B.BO,0B.TC,OB.RD,OB.RA,OB.ND, 
OB.DD,OB.BM 

-GLOBL OB.TH,OB.TB,OB.TI,OB.CR,OB.LP,OB.PR,OB.PP,OB.PL,OB.MT 

-GLOBL OB.DT,OB.CS,OB.CP,0B.FH,OB.MH,OB.FL 


. ENDC 
B.OT = 0 ;Object type value 
B.UN = 1 ;Object type unit number 
B.RC = B.OT+2 ;Offset to remote connect # 
B.RP = B.RN+4 ;Offset to remote process name [RAD50] 
B.RU = B.RP+4 ;Offset to remote UIC [.WORD 
; GROUP ,USER] 
B.NA = B.RU+4 ;Offset to # of user arguements 
B.UA = B.NA+2 ;Offset to first user arguement 
B.MN = B.UA ;Minimum size of buffer [0 arguements] 
B.MX = B.MN+10 ;Maximum size of buffer [8. arguments] 
NT.IN = 10 ;Send this message at AST level [XMIT] 
NT.NS = 1 ;No status message required [RECV] 
CR.UR = ;Connect reject [remote user 
; rejection] 
CR.NR = 3 ;Connect reject [remote NCS rejection] 
CR.MX = 6 ;Maximum reason 
CR.NO = 0 ;Reject by NCS 
CR.N1 = 1 ;Tco many connects to remote node 
CR.N2 = 2 ;Tco many connects to remote process 
CR.N3 = 3 ;Process does not exist on this node 
CR.N4 = 4 ;Object type does not exist on this 
; node 
CR.N5 = 5 ;Destination address in use 
CR.N6 = 6 ;Nede shutting down 
CR.N7 = 7 
CR.N8 = 8. 
CR.N9 = ll ;Invalid task name 
CR.N1O0 = 12 ;Invalid qualifier 
CR.N11 = 13 ;Bad destination parameter 
CR.DI = 4 ;Disconnect initiate 
CR.DT = 5 ;Disconnect terminate [CONFIRM] 
CR.DA = 6 ;Disconnect abort 
LB.N=0 ; Loopback normal 
LB.E=2 ; Loopback echo mode 
CT.IN = 0 Connect initiate 
CT.CN = 1 Connect confirm 
IA.ABO = -5 ;Disconnect abort [partner terminated] 
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IA.NFW = 177673 


IA.ISM = 
CN.IN 
CN .OU0 
CN.UT 
CN .NT 
OB.TA 
OB.FS 
OB.SQ 
OB.BO 
OB.TC 
OB.RD 
OB.RA 
OB.ND 
OB.DD 10 

OB.BM ll 

;12-17 RESERVED 
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OB.TH = 20 
OB.TB = 21 
OB.TI = 22 
OB.CR = 23 
OB.LP = 24 
OB.PR = 25 
OB.PP = 26 
OB.PL = 27 
OB.MT = 30 
OB.DT = 31 
OB.CS = 32 
OB.CP = 33 
OB.FH = 34 
OB.MH = 35 
OB.FL = 36 


~MACRO COMDFS$ A 
- ENDM 

-LIST 

- ENDM 

- END 


MACRO EXPANSIONS 


sDisconnect requested [partner did 

; disc QIO] 

;Topology change -- partner no longer 
; reachable 

;Interrupt semaphore from partner 

sIf set: inhibit incoming connections 
sIf set: inhibit outgoing connections 
;I1f set: user tap 

;If set: NCL tap 

;Task 

*File system [dap] 

*Sequential devices [DAP] 

;Boot task 

;Terminal control task 

;Remote directives 

;Resource allocater 

sNetwork directory service 

*DDCMP link 

;Boot message link 


:Terminal handler 
sTerminal : block mode 
:Terminal : interactive 
Card reader 

;Line printer 

:PAPER TAPE READER 
;Paper tape punch 
sPlotter ans 
;Magnetic tape 
;DECTAPE 

sCassette 

;Card punch 

*Fixed head disk 
;Moving head disk 
;Floppy disk 


C.7 PROGRAM LOGICAL ADDRESS SPACE EXTENSION MACRO EXPANSIONS 


C.7.1 ATRGS, ATRGSC, and ATRGSS Macros 


These macros generate the code to attach a region. 


.MACRO ATRGS RDB 
»MCALL OFFS 
.IF NDF $SSGLB 
sBYTE. “S7 .y2 
.WORD RDB 
.ENDC 

.IF NDF A.TRBA 
OFFS 

OFFS A.TRBA,2 
~ENDC \ 
.ENDM ATRGS 
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~MACRO ATRGSC RDB,CS,ERR 
~-MCALL ATRGS$ ,DIR$ 
-IF NDF $$$GLB 
-PSECT $DPBS$ 
$$$=. 
-IFTF 
ATRGS RDB 
-IFT 
-PSECT CS 
DIRS #$$$,ERR 
- ENDC 
~ENDM ATRGSC 


»MACRO ATRGSS RDB,ERR 
»MCALL DIRS ,MOV$ 

MOVS RDB 

MOV (PC)+,-(SP) 

~-BYTE 57.,2 

DIRS ,ERR 

-ENDM ATRGSS 


C.7.2 .BLK., .BLKB., and .BLKW. Macros 


These macros define the block offset symbol. The 
Address Space definition macros use these Macros. 


-MACRO .BLKB. NUM,SYM,GBL 
-IF NB <SYM> 
»IF IDN <DEFSG>,<GBL> 
SYM==S$$ 
~IFF 
SYM=SSS 
»ENDC 
~ENDC 
$$$=S$SS+NUM 
-ENDM .BLKB. 
«MACRO .BLKW. NUM,SYM,GBL 
-IF NB <SYM> 
-IF IDN <DEFS$G>,<GBL> 
SYM==S$S$ 
~IFF 
SYM=SS$ 
» ENDC 
» ENDC 
$$$=S$$+<2*NUM> 
-ENDM .BLKW. 


-MACRO .BLK. 
$$$=0 
-ENDM .BLK. 


C.7.3 CRAWS, CRAWSC, CRAWSS Macro 


Program 


These macros generate the code to create an address window. 


»-MACRO CRAWS WDB 
»MCALL OFFS 

-IF NDF $SSGLB 
-BYTE 117.,2 
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-WORD WDB 
~ENDC 

.IF NDF C.RABA 
OFFS 

OFFS C.RABA,2 
~ENDC 

~ENDM CRAWS 


»MACRO CRAWSC WDB,CS,ERR 
.MCALL CRAWS ,DIRS$ 
»IF NDF $$$GLB 
~PSECT SDPBSS 

$$$=. 
~IFTF 
CRAWS WDB 
~IFT 
.PSECT CS 
DIRS #$$$,ERR 
.ENDC 
»ENDM CRAWSC 


»MACRO CRAWSS WDB,ERR 
»MCALL DIRS ,MOVS 

MOVS WDB 

MOV (PC)+,-(SP) 

~BYTE 117.,2 

DIR$ ,ERR 

~ENDM CRAWSS 


C.7.4 CRRG$, CRRGSC, and CRRGSS Macros 
These macros generate the code to create a region. 


».MACRO CRRG$ RDB 
»MCALL OFFS 
.IF NDF $S$S$GLB 
~BYTE 55.,2 
»WORD RDB 
»ENDC 

.1F NDF C.RRBA 
OFFS 

OFFS C.RRBA,2 
»ENDC 

»-ENDM CRRG$ 


»MACRO CRRGSC RDB,CS,ERR 
.MCALL CRRGS$ ,DIRS 
~IF NDF $$S$GLB 
.PSECT $DPB$$ 

$$S=. 
~IFTF 
CRRG$ RDB 
.IFT 
.PSECT CS 
DIRS #$$S$,ERR 
.ENDC 
~.ENDM CRRGSC 


»MACRO CRRGS$S RDB,ERR 
»MCALL DIRS ,MOVS 

MOVS RDB 

MOV (PC)+,-(SP) 
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«BYTE. 55 %52 
DIRS ,ERR 
-ENDM CRRGSS 


C.7.5 DTRG$, DTRGSC, and DTRGSS Macros 
These macros generate the code to detach a region. 


«MACRO DTRGS RDB 
»MCALL OFFS 
»IF NDF $SSGLB 
~-BYTE 59.,2 
-WORD RDB 
-ENDC 

-IF NDF D.TRBA 
OFFS 

OFFS D.TRBA,2 
-ENDC 

-ENDM DTRGS$ 


-MACRO DTRGSC RDB,CS,ERR 
-MCALL DTRGS ,DIRS 

-IF NDF S$SSGLB 

-PSECT SDPBSS 


»PSECT CS 
DIRS #$$$,ERR 
- ENDC 

-ENDM DTRGSC 


-MACRO DTRGSS RDB,ERR 
~MCALL DIRS ,MOVS 

MOVS RDB 

MOV (PC)+,-(SP) 

~-BYTE 59.,2 

DIRS ,ERR 

»ENDM DTRGSS 


C.7.6 ELAWS, ELAWSC, and ELAWSS Macros 
These macros generate the code to eliminate an address window. 


-MACRO ELAWS WDB 
-MCALL OFFS 

-IF NDF $SSGLB 
BYTE 119.2 


»~WORD WDB 
-ENDC 

-IF NDF E.LABA 
OFFS 

OFFS E.LABA,2 
-ENDC 


-ENDM ELAWS 


-MACRO ELAWSC WDB,CS,ERR 
»MCALL ELAWS ,DIRS$ 
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-IF NDF $SSGLB 

»-PSECT SDPBS$ 
$$$=. 

~IFTF 

ELAWS WDB 

.IFT 

.PSECT CS 

DIRS #$5$,ERR 

~ENDC 

~ENDM ELAWSC 


-MACRO ELAWSS WDB,ERR 
-MCALL DIRS ,MOVS 

MOVS WDB 

MOV (PC)+,-(SP) 

»BYTE 119.,2 

DIRS ,ERR 

-ENDM ELAWSS 


C.7.7 GMCX$, GMCXS$C, and GMCX$S Macros 
The macros generate the code to get the mapping context. 


«MACRO GMCX$ WVEC 

»MCALL OFFS 

.IF NDF SS$S$GLB 

BYTE 113.,2 

»WORD WVEC 

. ENDC 

.IF NDF G.MCVA 

OFFS 

OFFS G.MCVA,2 

» ENDC 

~ENDM GMCXS 

»~MACRO GMCXSC WVEC,CS,ERR 

-MCALL GMCXS ,DIRS 

.IF NDF $S$SGLB 

~-PSECT SDPBS$ 
$$$=. 

.IFTF 

GMCX$ WVEC 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

.ENDC 

~ENDM GMCXSC 

~MACRO GMCX$S WVEC,ERR 

-MCALL DIRS ,MOVS 

MOVS WVEC 

MOV (PC) +,~(SP) 

~-BYTE 113.,2 

DIRS ,ERR 

-ENDM GMCXS$S 


C.7.8 GREGS, GREGSC, and GREGSS Macros 


These macros get region parameters. They are a special case of the 
get partition parameters macros. 
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»MACRO GREGS$ RID,BUF 
»MCALL OFFS 
-IF NDF SSSGLB 
-BYTE 65.,4 
-WORD 0,RID 
~WORD BUF 
»ENDC 
-IF NDF G.RGID 
»NLIST 
OFFS 
OFFS ,2 
OFFS G.RGID,2 
OFFS G.RGBA,2 
»IF NDF G.RGRB 
$SSOST=0 
-IRP X,<<G.RGRB,2>,<G.RGRS ,2>,<G.RGFW,2>> 
OFFS X 
~ENDM 
~ENDC 
.LIST 
~ENDC 
~ENDM GREGS 
»-MACRO GREGSC RID,BUF,CS,ERR 
.MCALL GREGS ,DIRS 
-IF NDF S$SSSGLB 
-PSECT SDPBSS$ 
$$$=. 
~IFTF 
GREGS$ RID,BUF 
IFT 
-PSECT CS 
DIRS #$$$,ERR 
.»ENDC 
~ENDM GREGSC 
»MACRO GREGSS RID,BUF,ERR 
-MCALL MOVS ,DIRS ,OFFS$ 
MOVS BUF 
MOVS RID 
CLR -(SP) 
MOV (PC) +,-(SP) 
-BYTE 65.,4 
DIRS ,ERR 
.IF NDF G.RGRB 
-NLIST 
$SSOST=0 
-IRP X,<<G.RGRB,2>,<G.RGRS,2>,<G.RGFW,2>> 
OFFS X 
~ENDM 
-LIST 
~ENDC 
-ENDM GREGSS 


C.7.9 MAPS, MAPSC, MAPSS Macros 
These macros generate the code to map an address window. 


.MACRO MAPS WDB 
~MCALL OFFS 

-IF NDF $SS$GLB 
.BYTE 121.,2 
.WORD WDB 

»ENDC 
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-IF NDF M.APBA 
OFFS 

OFFS M.APBA,2 
~ENDC 

~ENDM MAPS 


»MACRO MAPSC WDB,CS,ERR 


»MCALL. MAPS ,DIRS 

-IF NDF S$SSGLB 

-PSECT SDPBSS$ 
$$$=. 

~IFTF 

MAPS WDB 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

~ENDM MAPSC 


-MACRO MAPSS WDB,ERR 


»MCALL DIRS ,MOV$S 
MOVS WDB 

MOV (PC) +,-(SP) 
-BYTE 121.,2 
DIRS ,ERR 

-ENDM MAPS$S 


C.7.10 RDBBKS Macro 


MACRO EXPANSIONS 


RDBBK$ generates a region definition block. 


-MACRO RDBBK$ S1IZ,NAM,PAR,STS,PRO 


.MCALL RDBDFS$ ,R50$ 
RDBDFS 


-WORD 0 
-WORD SIZ 
R50$ NAM 
R50$ PAR 
-WORD STS 
.WORD PRO 
~ENDM RDBBKS 


;Define region definition block 
3; symbols 
;Region ID 
Size of region (32w blocks) 
;Name of region (RAD50) 
;Region's main partition name (RAD50) 
;Region status word 
;Region protection word 


C.7.11 RREFS, RREFSC, and RREFSS Macros 


These macros generate the code to receive by reference. 


~MACRO RREFS$ WDB 
»MCALL OFFS 
-IF NDF $$S$GLB 
~-BYTE 81.,2 
.WORD WDB 
.ENDC 

.IF NDF R.REBA 
OFFS 

OFFS R.REBA,2 
~ENDC 

~ENDM RREFS 
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-MACRO RREFSC WDB,CS,ERR 

.MCALL RREFS ,DIRS$ 

~IF NDF S$SSGLB 

»PSECT SDPBS$ 
$$$=, 

~IFTF 

RREFS WDB 

IFT 

-PSECT CS 

DIRS #$$$,ERR 

~ENDC 

~ENDM RREFSC 


-MACRO RREFSS WDB,ERR 
-MCALL DIRS ,MOVS 

MOVS WDB 

MOV (PC) +,-(SP) 

-BYTE 81.,2 

DIRS ,ERR 

~ENDM RREFSS 


C.7.12 SREF$, SREFSC, and SREFSS Macros 
These macros generate the code to send by reference. 


.MACRO SREFS TASK,WDB,EFN 
~MCALL R50S ,OFFS 
.IF NDF $S$SGLB 
-BYTE 69.,5 
R50$ TASK 
.WORD EFN 
-WORD WDB 
» ENDC 
.IF NDF S.RETN 
-IRP X,<,<S.RETN,4>,<S.REEF,2>,<S.REBA,2>> 
OFFS X 
.ENDM 
-ENDC 
-ENDM SREFS 
.MACRO SREFSC TASK,WDB,EFN,CS,ERR 
-MCALL SREFS ,DIRS 
~IF NDF $$SGLB 
-PSECT SDPBS$ 


$$$=, 
~IFTF 
SREFS TASK,WDB,EFN 
IFT 
-PSECT CS 
DIRS #$$$,ERR 
. ENDC 


~-ENDM SREFSC 


-MACRO SREFSS TSKADR,WDB,EFN,ERR 
-MCALL DIR$ ,MOVS ,RFAS$ 

MOVS WDB 

MOVS EFN 

RFAS TSKADR 

MOV (PC)+,-(SP) 

~-BYTE 69.,5 

DIRS ,ERR 

-ENDM SREFSS 


C-108 


Crrste 


MACRO EXPANSIONS 


SRRAS, SRRASC, and SRRASS Macros 


These macros generate the code for the SPECIFY RECEIVE BY 
AST directive. 


$$$. 


Ca Pwl4 


»MACRO SRRAS AST 
-MCALL OFFS 
-IF NDF $SSGLB 
~BYTE 21.,2 
.WORD AST 
~ENDC 

.IF NDF S.RRAE 
»NLIST 

OFFS 

OFFS S.RRAE,2 
-LIST 

.ENDC 

.ENDM SRRAS 


.MACRO SRRASC AST,CS,ERR 
»MCALL SRRAS ,DIRS 

.IF NDF S$SS$S$GLB 

»PSECT S$DPBS$ 


.IFTF 

SRRA$ AST 
«IFT 

-PSECT CS 
DIRS #$$$,ERR 
. ENDC 


~ENDM SRRASC 

«MACRO SRRASS AST,ERR 

«MCALL MOVS ,DIRS 

MOVS$ AST ; 
MOV (PC)+,-(SP) 

~BYTE 21.,2 

DIRS ,ERR 

.ENDM SRRASS 


UMAPS, UMAPSC, and UMAP$S Macros 


These macros generate the code to unmap an address window. 


$$$=. 


»~MACRO UMAPS WDB 
»MCALL OFFS 
.IF NDF $SS$GLB 
~BYTE 123.,2 
»WORD WDB 
.»ENDC 

.IF NDF U.MABA 
OFFS 

OFFS U.MABA,2 
. ENDC 

»ENDM UMAPS 


~MACRO UMAPSC WDB,CS,ERR 
.MCALL UMAPS ,DIRS 

.IF NDF $$SGLB 

»-PSECT S$DPBS$ 


~IFTF 
UMAPS WDB 
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IFT 

-PSECT CS 
DIRS #$$$,ERR 
.ENDC 

.ENDM UMAPSC 


-MACRO UMAPSS WDB,ERR 
»MCALL DIRS ,MOV$ 

MOVS WDB 

MOV (PC)+,-(SP) 

~-BYTE 123.,2 

DIRS ,ERR 

~ENDM UMAPSS 


WDBBKS$ Macro 


WDBBKS generates a window definition block. 


»-MACRO WDBBK$ APR,SIZ,RIO,OFF,LEN,STS,SRB 
-MCALL WDBDFS$ 


WDBDFS$ Define window definition block 
symbols 

»~BYTE 0,APR :Window ID / base APR. 

~WORD 0 ;Virtual base address (bytes) 

-WORD SIZ ;Window size (32w blocks) 

«WORD RID ;Region ID 

-WORD OFF ;Offset in partition (32w blocks) 

-WORD LEN ;Length to map (32w blocks) 

-WORD STS ;Status word 

-WORD SRB 7Send/receive buffer virtual address 


-ENDM WDBBKS$ 


C.8 RELATIVE FILES MACROS - EXPANSIONS 


C.8.1 RCLOS$ Macro 


RCLOS$ 


closes a file. 


-MACRO RCLOS$ FDB,ERR 
»-MCALL LDFDB$ ,ERR$ 
LDFDBS FDB 

JSR PC,.RCLOS 


ERRS 


ERR 


-ENDM RCLOS$ 


C.8.2 


RFDBT$ Macro 


RFDBT$ defines the relative file descriptor bits. 


-MACRO RFDBT$ GLOBL 
~MCALL DEFINS 

-. -GBL=0 
IDN,<GLOBL>,<DEFS$G>, ...GBL=1 


-IIF 


Cc-110 


MACRO EXPANSIONS 


Relative File Flags Byte 


DEFINS RF.WRT,1 ;Set if bit table record 

; buffer dirty 
DEFINS RF.EXT,2 ;Set if extend is allowed 
DEFINS RF.BEX,4 ;Set if extend attempted when 


3; restricted 
Relative File Value Byte 


DEFINS RB.NEW,1 s;New bit value to set 
DEFINS RB.NCH,2 71 if not changing value 
DEFINS RB.VAL,4 ;Bit value read 


-MACRO RFDBTS ARG 
~ENDM RFDBTS$ 
-ENDM RFDBT$ 


C.8.3 RFINDS Macro 
RFINDS finds the next existing record. 


.MACRO RFINDS FDB,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDBS FDB 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RFIND 

ERRS ERR 

~-ENDM RFINDS 


C.8.4 RFOFSL Macro 

RFOFSL locally defines relative file record offsets. 
»-MACRO RFOFSL 
»MCALL RFOFFS 


RFOFFS DEFSL 
-ENDM RFOFSL 


C.8.5 REFOFFS Macro 
RFOFFS defines the offsets for the relative file extension of the FDB. 
»-MACRO RFOFFS OFFSET 
-MCALL OFFSET,DEFSI,FDBSZ$ 
FDBSZ$ 
DEFSI S.FDB 


Relative File Record Section 


OFFSET R.RCNM,4 :Relative record number 
OFFSET R.CLSZ,4 Cluster size 

OFFSET R.FLAG,1 ;Flags byte 

OFFSET R.BTVL,1l Value byte 

OFFSET R.BTSZ,2 : :;Bit table record size 
OFFSET R.BTBF,2 :Bit table record buffer 
OFFSET R.BTN,2 :Bit table number 

OFFSET R.BTRC,2 ;Bit table record number 


CeLit 


MACRO EXPANSIONS 


OFFSET S.RFD ;Size of RFDB 
~IIF IDN,<DEFSN>,<OFFSET>, .MEXIT 
-MACRO RFOFFS ARG 

-ENDM RFOFFS 

-ENDM RFOFFS 


C.8.6 RGETS Macro 
RGETS gets a relative file. 


»-MACRO RGETS FDB,INADR,MAXCNT,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS§ 

LDFDBS$ FDB 

CMOVSW INADR,F.URBD+2 

CMOVSW MAXCNT,F.URBD 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RGET 

ERR$ ERR 

-ENDM RGETS 


C.8.7 ROPNS Macro 
ROPNS opens a file. 


+MACRO ROPNS FDB,FACC,LUN,FNPT,DFNB, RACC,URBA,URBS,ERR 
-MCALL FDOPSR,FDRCS$R,ERR$ ,CMOVSB 

FDOPSR FDB,LUN,FNPT,DFNB,FACC 

FDRCSR ,RACC,URBA,URBS 

-GLOBL .ROPEN 

JSR PC,.ROPEN 

ERR$ ERR 

-ENDM ROPNS 


C.8.8 ROPNSA Macro 

ROPNSA opens a file for appending. 
»~MACRO ROPNSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
~MCALL ROPNS 


ROPNS FDB,#FO.APD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPNSA 


C.8.9 ROPNSM Macro 

ROPNSM opens a file for modification. 
»~MACRO ROPNSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL ROPNS 


ROPNS FDB,#FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPNSM 
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C.8.10 ROPNSR Macro 

ROPNSR opens a file for reading. 
.MACRO ROPNSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL ROPNS 


ROPNS FDB,#FO.RD,LUN,FNPT,,RACC,URBA,URBS,ERR 
«ENDM ROPNSR 


C.8.11 ROPNSU Macro 

ROPNSU opens a file for updating. 
;MACRO ROPNSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL ROPNS 


ROPNS FDB,#FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
«ENDM ROPNSU 


C.8.12 ROPNSW Macro 

ROPNSW opens a file for writing. 
»MACRO ROPNSW PDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»MCALL ROPNS ae 


ROPNS FDB,#FO.WRT,LUN,FNPT,,RACC,URBA,URBS,ERR 
«ENDM ROPNSW 


c.8.13 ROPSSA Macro 

ROPSSA opens a shared file for appending. 
.MACRO ROPSSA FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
.MCALL ROPNS 


ROPNS FDB,#FA.SHR!FO.APD,LUN,FNPT,,RACC,URBA,URBS, ERR 
-ENDM ROPSSA 


C.8.14 ROPSSM Macro 

ROPS$M opens a shared file for modification. 
.MACRO ROPSSM FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
»MCALL ROPN$ 


ROPNS FDB,#FA.SHR!FO.MFY,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPSSM 


C.8.15 ROPSSR Macro 

ROPSSR opens a shared file for reading. 
.MACRO ROPSSR FDB,LUN,FNPT,RACC,URBA,URBS,ERR 
-MCALL ROPN$ 


ROPNS FDB,#FA.SHR!FO.RD,LUN,FNPT,,RACC,URBA,URBS ,ERR 
-ENDM ROPSSR 
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C.8.16 ROPSSU Macro 
ROPSSU opens a shared file for updating. 


~MACRO ROPSSU FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

~MCALL ROPNS 

ROPNS$ FDB,#FA.SHR!FO.UPD,LUN,FNPT,,RACC,URBA,URBS,ERR 
-ENDM ROPSSU 


C.8.17 ROPSSW Macro 
ROPSSW opens a shared file for writing. 


-MACRO ROPSSW FDB,LUN,FNPT,RACC,URBA,URBS,ERR 

-MCALL ROPNS 

ROPN$ FDB,#FA.SHR!FO.WRT,LUN,FNPT, ,RACC,URBA,URBS,ERR 
-ENDM ROPSSW 


C.8.18 RPORTS Macro 
RPORTS reports the existence of a record for a relative file. 


-MACRO RPORTS FDB,LRCNM,HRCNM,ERR 
-MCALL RPRTCS$ ; 
RPRTC$ <FDB>,#-1,<LRCNM> ,<HRCNM> , <ERR> 
-ENDM RPORTS 


C.8.19 RPRTCS Macro 
RPRTC$ reports on and optionally changes the existence of a record. 


«MACRO RPRTCS$ FDB,CHGVAL,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,CMOV$B,ERRS 

LDFDB$ FDB 

CMOVSB CHGVAL,R.BTVL 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RPRTC 

ERRS$ ERR 

-ENDM RPRTCS$ 


C.8.20 RPUT$ Macro 
RPUTS puts a relative file. 


-MACRO RPUTS FDB,OUTADR,OUTCNT,LRCNM,HRCNM,ERR 
-MCALL LDFDBS ,CMOVSW,ERRS 

LDFDB3 FDB 

CMOVSW OUTADR,F.NRBD+2 

CMOVSW OUTCNT,F.NRBD 

CMOVSW LRCNM,R.RCNM+2 

CMOVSW HRCNM,R.RCNM 

JSR PC,.RPUT 

ERRS$ ERR 

-ENDM RPUTS 
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C.9 QIOMAC - QIOSYM MACRO DEFINITIONS 


C.9.1 DRERRS Macro 


Defines the directive error codes returned in the directive status 
word. File control services (FCS) returns these codes in the F.ERR 
byte of the File Descriptor Block (FDB). To distinguish them from the 
overlapping codes from handler and file primitives, the F.ERR+1 byte 
in the FDB is negative for a directive error code. 


»MACRO DRERRS $SSGBL 
eMCALL .QIOE.,DEFINS 

.IF IDN,<SSSGBL> ,<DEFS$G> 
.. GBL=1 

~IFF 

.. GBL=0 

~ENDC 

~LIF NDF,SSMSG,$S$SMSG=0 


Standard Error Codes Returned by Directives in the Directive Status 
Word 


-QIOE. IE.UPN,-01.,<INSUFFICIENT DYNAMIC STORAGE> 

-QIOE. IE.INS,-02.,<SPECIFIED TASK NOT INSTALLED> 

.QIOE. IE.PTS,-03.,<PARTITION TOO SMALL FOR TASK> 

-OQIOE. IE.UNS,-04.,<INSUFFICIENT DYNAMIC STORAGE FOR SEND> 
-QIOE. IE.ULN,-05.,<UN-ASSIGNED LUN> 

.QIOE. IE.HWR,-06.,<DEVICE HANDLER NOT RESIDENT> 

-QIOE. IE.ACT,-07.,<TASK NOT ACTIVE> 

-QIOE. IE.ITS,-08.,<DIRECTIVE INCONSISTENT WITH TASK STATE> 
-QIOE. IE.FIX,-09.,<TASK ALREADY FIXED/UNFIXED> 

-QIOE. IE.CKP,-10.,<ISSUING TASK NOT CHECKPOINTABLE> 
.QIOE. IE.TCH,-11.,<TASK IS CHECKPOINTABLE> 

-QIOE. IE.RBS,-15.,<RECEIVE BUFFER IS TOO SMALL> 

.QIOE. IE.PRI,~16.,<PRIVILEGE VIOLATION> 

.QIOE. IE.RSU,-17.,<RESOURCE IN USE> 

.QIOE. IE.NSW,-18.,<NO SWAP SPACE AVAILABLE> 

-QIOE. IE.ILV,-19.,<ILLEGAL VECTOR SPECIFIED> 

-QIOE. IE.AST,-80.,<DIRECTIVE ISSUED/NOT ISSUED FROM AST> 
-QIOE. IE.MAP,-81.,<ILLEGAL MAPPING SPECIFIED> 

.QIOE. IE.IOP,-83.,<WINDOW HAS I/O IN PROGRESS> 

.QIOE. IE.ALG,-84.,<ALIGNMENT ERROR> 

.QIOE. IE.WOV,-85.,<ADDRESS WINDOW ALLOCATION OVERFLOW> 
-QIOE. IE.NVR,-86.,<INVALID REGION ID> 

-QIOE. IE.NVW,-87.,<INVALID ADDRESS WINDOW ID> 

-QIOE. IE.ITP,-88.,<INVALID TI PARAMETER> 

-QIOE. IE.IBS,-89.,<INVALID SEND BUFFER SIZE (° 4GP so: 255007 2 
.QIOE. IE.LNL,-90.,<LUN LOCKED IN USE> 

-QIOE. IE.IUI,-91.,<INVALID UIC> 

.QIOE. IE.IDU,-92.,<INVALID DEVICE OR UNIT> 

.QIOE. IE.ITI,-93.,<INVALID TIME PARAMETERS> 

.QIOE. IE.PNS,-94.,<PARTITION/REGION NOT IN SYSTEM> 
.QIOE. IE.IPR,-95.,<INVALID PRIORITY ( .GT. 250.)> 

-QIOE. IE.ILU,-96.,<INVALID LUN> 

.QIOE. IE.IEF,-97.,<INVALID EVENT FLAG ( .GT. 64.)> 
-QIOE. IE.ADP,-98.,<PART OF DPB OUT OF USER'S SPACE> 
.QIOE. IE.SDP,-99.,<DIC OR DPB SIZE INVALID- 
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Success Codes from Directives - Placed in the Directive Status Word 


DEFINS$ 
DEFINS 


DEFINS 


IS.SET,2 
IS.SPD,2 


~IF EQ,SSMSG 
»MACRO DRERRS A 
~ENDM DRERRS 


«ENDC 


-ENDM DRERRS 


C.9.2 


FILIOS defines 


FILIOS Macro 


the 


independent. 


. MACRO 
»MCALL 


-IF IDN,<SSSGBL>,<DEFSG> 


FILIOS $SSGBL 
-WORD.,DEFINS 


ees .GBL=1 


~IFF 


ee ~GBL=0 


general QIO 


;Event flag was clear 

; from CLEAR EVENT FLAG. directive 
rEvent flag was set 

; from SET EVENT FLAG directive 
;Task was suspended 


function codes that are 


General QIO Qualifier Byte Definitions 


»WORD. 
-WORD. 
-WORD. 
~WORD. 


IQ.X,001,000 
IQ.Q,002,000 
IQ.S,004,000 
IQ.UMD ,004,000 


Express Queue Commands 


-WORD. 
-WORD. 
-WORD. 
-WORD. 
-WORD. 
-WORD. 


IO0.KIL,012 ,000 
IO.RDN ,022,000 
IO.UNL,042,000 
IO.LTK,050 ,000 
IO.RTK ,060 ,000 
IO.SET,030,000 


;No error recovery 

;Queue request in express queue 
;Synonym for IQ.UMD 

;User mode diagnostic status required 


7Kill current request 

71/0 rundown 

;Unload I/O handler task 
;Load a task image file 
;Record a task image file 
;Set characteristics function 


General Device Handler Codes 


-WORD. 
»WORD. 
-WORD. 
» WORD. 
»WORD. 


Directory Primitive Codes 


»WORD. 
-WORD. 
-WORD. 


IO.WLB,000,001 
IO.RLB,000,002 
I0.LOV,010 ,002 
IO.ATT,000 ,003 
IO.DET,000,004 


IO.FNA,000,011 
IO.RNA,000 ,013 
IO.ENA,000,014 


File Primitive Codes 


»WORD. 
»WORD. 
»WORD. 
-WORD. 
-WORD. 


IO0.CLN,000,007 
IO.ULK ,000,012 
IO.ACR,000,015 
IO.ACW,000 ,016 
IO.ACE,000,017 


;Write logical block 

7Read logical block 

;Load overlay (disk driver) 
Attach a device to a task 
;Detach a device from a task 


;Find file name in directory 
;Remove file name from directory 
;Enter file name in directory 


;Close out LUN 
sUnlock block 
s;Access for read 
;Access for write 
7;Access for extend 
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»WORD. IO.DAC,000,020 ;De-access file 

»WORD. IO.RVB,000,021 >Read viritual block 
»WORD. I0O.WVB,000,022 »Write virtual block 
«WORD. IO.EXT,000,023 sExtend file 

».WORD. IO.CRE,000 ,024 :Create file 

~WORD. IO.DEL,000,025 sDelete file 

».WORD. IO.RAT,000,026 :;Read file attributes 
»-WORD. IO.WAT,000 ,027 *Write file attributes 
»-WORD. IO.APV,010,030 >Privileged ACP control 
»-WORD. IO.APC,000,030 *ACP control 

»-MACRO FILIOS A 

~ENDM FILIOS 

-ENDM FILIOS 


C.9.3 .IOER. Macro 


This macro defines handler error codes that are returned in the I/0 
Status block are defined through this macro. This macro then 
conditionally invokes the message generating macro for the QIOSYM.MSG 
file. 


-MACRO .IOER. SYM,LO,MSG 
DEFINS SYM,LO 

-IF GT,$$MSG 

-MCALL .IOMG. 

~IOMG. SYM,LO,<MSG> 
»ENDC 

~-ENDM .IOER. 


C.9.4 IOERRS Macro 


This macro defines the error codes returned by device handlers and 
file primitives in the first word of the I/O status block. The File 
Control Services also return these codes in the F.ERR byte in the File 
Descriptor Block (FDB). The F.ERR+1] byte is 0 if F.ERR contains a 
handler or FCP error code. 


»-MACRO IOERRS S$SSGBL 
.MCALL .IOER.,DEFINS 

.IF IDN,<SSSGBL> ,<DEFSG> 
.. -GBL=1 

~IFF 

‘ee »~GBL=0 

.ENDC 

.IIF NDF,$SSMSG,$$SMSG=0 


System standard codes, used by executive and drivers: 


-IOER. IE.BAD,~-01.,<BAD PARAMETERS> 

.IOER. IE.IFC,-02.,<INVALID FUNCTION CODE> 
-IOER. IE.DNR,-03.,<DEVICE NOT READY> 

,IOER. IE.VER,-04.,<PARITY ERROR ON DEVICE> 
.IOER. IE.ONP,-05.,<HARDWARE OPTION NOT PRESENT> 
.IOER. IE.SPC,-06.,<ILLEGAL USER BUFFER> 

.IOER. IE.DNA,-07.,<DEVICE NOT ATTACHED> 

.IOER. IE.DAA,-08.,<DEVICE ALREADY ATTACHED> 
.IOER. IE.DUN,-09.,<DEVICE NOT ATTACHABLE> 
.IOER. IE.EOF,-10.,<END OF FILE DETECTED> 

,IOER. IE.EOV,-11.,<END OF VOLUME DETECTED> 
,IOER. IE.WLK,-12.,<WRITE ATTEMPTED TO LOCKED UNIT> 
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-IOER. IE.DAQ,-13.,<DATA OVERRUN> 

-IOER. IE.SRE,-14.,<SEND/RECEIVE FAILURE> 

-IOER. IE.ABO,-15.,<REQUEST TERMINATED> 

-IOER. IE.PRI,-16.,<PRIVILEGE VIOLATION> 

-IOER. IE.RSU,-17.,<SHARABLE RESOURCE IN USED 

-IOER. IE.OVR,-18.,<ILLEGAL OVERLAY REQUEST> 

-IOER. IE.BYT,-19.,<ODD BYTE COUNT (OR VIRTUAL ADDRESS) > 
-IOER. IE.BLK,-20.,<LOGICAL BLOCK NUMBER TOO LARGE> 
-IOER. IE.MOD,-21.,<INVALID UDC MODULE #> 

-IOER. IE.CON,-22.,<UDC CONNECT ERROR> 

-IOER. IE.BBE,-56.,<BAD BLOCK ON DEVICE> 

-IOER. IE.STK,-58.,<NOT ENOUGH STACK SPACE (FCS OR FCP) > 
-IOER. IE.FHE,-59.,<FATAL HARDWARE ERROR ON DEVICE> 
-IOER. IE.EOT,-62.,<END OF TAPE DETECTED> 

-IOER. IE.OFL,-65.,<DEVICE OFF LINE> 

-IOER. IE.BCC,-66.,<BLOCK CHECK, CRC, OR FRAMING ERROR> 


File Primitive Codes 


-IOER. IE.NOD,~23.,<CALLER'S NODES EXHAUSTED> 

-IOER. IE.DFU,-24.,<DEVICE FULL> 

-IOER. IE.IFU,-25.,<INDEX FILE FULL> 

-IOER. IE.NSF,-26.,<NO SUCH FILED 

-IOER. IE.LCK,-27.,<LOCKED FROM READ/WRITE ACCESS> 
-IOER. IE.HFU,-28.,<FILE HEADER FULL> 

-IOER. IE.WAC,~29.,<ACCESSED FOR WRITE> 

-IOER. IE.CKS,-30.,<FILE HEADER CHECKSUM FAILURE> 
-IOER. IE.WAT,-31.,<ATTRIBUTE CONTROL LIST FORMAT ERROR> 
-IOER. IE.RER,-32.,<FILE PROCESSOR DEVICE READ ERROR> 
»IOER. IE.WER,-33.,<FILE PROCESSOR DEVICE WRITE ERROR> 
-IOER. ITE.ALN,-34.,<FILE ALREADY ACCESSED ON LUN> 
-IOER. IE.SNC,-35.,<FILE ID, FILE NUMBER CHECK> 

-IOER. IE.SQC,-36.,<FILE ID, SEQUENCE NUMBER CHECK> 
-IOER. IE.NLN,-37.,<NO FILE ACCESSED ON LUN> 

-IOER. IE.CLO,-38.,<FILE WAS NOT PROPERLY CLOSED> 
-IOER. ITE.DUP,-57.,<ENTER - DUPLICATE ENTRY IN DIRECTORY> 
-IOER. IE.BVR,-63.,<BAD VERSION NUMBER> 

-IOER. IE.BHD,-64.,<BAD FILE HEADER> 

-IOER. IE.EXP,~75.,<FILE EXPIRATION DATE NOT REACHED> 
-IOER. IE.BTF,-76.,<BAD TAPE FORMAT> 

-IOER. IE.ALC,~84.,<ALLOCATION FAILURE> 

-IOER. IE.ULK,-85.,<UNLOCK ERROR> 

-IOER. IE.WCK,~86.,<WRITE CHECK FAILURE> 


File Control Services Codes 


-IOER. IE.NBF,-39.,<OPEN - NO BUFFER SPACE AVAILABLE FOR FILE> 

-IOER. IE.RBG,-40.,<ILLEGAL RECORD SIZE> 

-IOER. IE.NBK,-41.,<FILE EXCEEDS SPACE ALLOCATED, NO BLOCKS> 

-IOER. IE.ILL,-42.,<ILLEGAL OPERATION ON FILE DESCRIPTOR 
BLOCK> 

-IOER., IE.BTP,-43.,<BAD RECORD TYPED 

-IOER. IE.RAC,-44.,<ILLEGAL RECORD ACCESS BITS SET> 

-IOER. IE.RAT,-45.,<ILLEGAL RECORD ATTRIBUTES BITS SET> 

-IOER. IE.RCN,-46.,<ILLEGAL RECORD NUMBER - TOO LARGE> 

-IOER. IE.2DV,-48.,<RENAME - 2 DIFFERENT DEVICES> 

-IOER. IE.FEX,-49.,<RENAME - NEW FILE NAME ALREADY IN USE> 

-IOER. IE.BDR,-50.,<BAD DIRECTORY FILE> 

-IOER. IE.RNM,-51.,<CANNOT RENAME OLD FILE SYSTEM> 

-IOER. IE.BDI,-52.,<BAD DIRECTORY SYNTAX> 

~IOER. IE.FOP,-53.,<FILE ALREADY OPEN> 

-IOER. IE.BNM,-54.,<BAD FILE NAME> 

-IOER. IE.BDV,-55.,<BAD DEVICE NAME> 

-TOER. IE.NFI,-60.,<FILE ID WAS NOT SPECIFIED> 
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~IOER. IE.IS5SQ,-61.,<ILLEGAL SEQUENTIAL OPERATION> 
IOER. IE.NNC,-77.,<NOT ANSI 'D' FORMAT BYTE COUNT> 


Network ACP Codes 


.IOER. IE.AST,-80.,<NO AST SPECIFIED IN CONNECT> 

,IOER. IE.NNN,-68.,<NO SUCH NODE> 

,IOER. IE.NFW,-69.,<PATH LOST TO PARTNER> ;This code must be 
3; odd 

~IOER. IE.BLB,-70.,<BAD LOGICAL BUFFER> 

.IOER. IE.TMM,-71.,<TOO MANY OUTSTANDING MESSAGES> 

.IOER. IE.NDR,-72.,<NO DYNAMIC SPACE AVAILABLE> 

. LOER. IE.CNR,-73.,<CONNECTION REJECTED> 

,IOER. IE.TMO,-74.,<TIMEOUT ON REQUEST> 

,IOER. IE.NNL,-78.,<NOT A NETWORK LUN> 


ICS/ICR Error Codes 


.IOER. IE.NLK,-79.,<TASK NOT LINKED TO SPECIFIED ICS/ICR 
INTERRUPTS > 

,IOER. IE.NST,-80.,<SPECIFIED TASK NOT INSTALLED> 

,IOER. IE.FLN,-81.,<DEVICE OFFLINE WHEN OFFLINE REQUEST WAS 
ISSUED> 


TTY Error Codes 


.IOER. IE.IES,-82.,<INVALID ESCAPE SEQUENCE> 
,IOER. IE.PES,-83.,<PARTIAL ESCAPE SEQUENCE> 


Successful Return Codes: 


DEFINS IS.PND,+00. ;Operation pending 

a DEFINS IS.SUC,+01. ;Operation complete, success 
_ DEFINS IS.RDD,+02. (RX11) Floppy disk successful 

+ completion of a read physical 
and a deleted data mark was 
seen in the sector header of 
the last sector. 
(A/D READ) At least one bad value 
was read (remainder may be good); 
bad channel is indicated by a 
negative value in the buffer. 


DEFINS IS.BV,+05. 


=e “oe “es NO we NO NS NO NO 


TTY Success Codes 


DEFINS IS.CR,<15*400+1> ;Carriage return was terminator 
DEFINS IS.ESC,<33*400+1> ;Escape (ALTMODE) was terminator 
DEFINS IS.CC,<3*400+1> sCONTROL-C was terminator 

DEFINS IS.ESQ,<233*400+1> ;Escape sequence was terminator 


DEFINS IS.PES,<200*400+1> ;Partial escape sequence terminator 


DEFINS IS.EOT,<4*400+1> *EOT was terminator (block mode 
; input) 

DEFINS IS.TAB,<11*400+1> ;TAB was terminator (forms mode 
; input) 

DEFINS IS.TMO,+2. ;Request timed out 

-IF EQ,$S$MSG 

»MACRO IOERRS A 

~ENDM IOERRS 

» ENDC 

»ENDM IOERRS 
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C.9.5 .QIOE. Macro 


This macro defines the QIO error codes. This macro then invokes the 


error message generating macro, “.IOMG.". The QIOSYM.MSG file uses 
error codes -129 through -256. 


»-MACRO .QIOE. SYM,LO,MSG 
DEFINS SYM,LO 

-IF GT,S$MSG 

«-MCALL .IOMG. 

~IOMG. SYM,<LO-128 .>,<MSG> 
- ENDC 

~ENDM .QIOE. 


Conditional Data for Writing a Message File 


-MACRO .IOMG. SYM,LO,MSG 

-WORD -“O<LO> 
-ASCIZ ~MSG* 

. EVEN 

-IIF LT, “O<SSSMAX+<LO>> ,SSSMAX=-*O<LO> 
~-ENDM .IOMG. 


C.9.6 QIOSYS Macro 


This macro defines standard QUEUE I/O directive function values and 
IOSB return values. To invoke at assembly time (with local 
definition) use: 


QIOSsyY$ ;Define symbols 
To obtain global definition of these symbols use: 
QIOSY$ DEFSG ;Symbols defined globally 


This macro can be called once only. It then redefines itself as a 
null, 


-MACRO QIOSYS $SS$GBL,S$SSMSG 

-IIF IDN,<SSSGBL>,<DEF$G>, .GLOBL QI.VER 

-IF IDN,<SSSMSG>,<DEFSS> 

$SSMAX=0 

SSMSG=1 

~LTFF 

$SMSG=0 

»ENDC 

»-MCALL IOERRS 

IOERRS $SS$GBL 7I/O error codes from handlers, FCP, 
3; FCS 

»-MCALL DRERRS 

DRERRS SSSGBL ;Directive status word error codes 

IF DIF,<SSSMSG>,<DEFSS> 

~MCALL FILIOS 


FILIOS $S$GBL ;Define general QIO function codes 
»MCALL SPCIOS 
SPCIOS S$S$GBL ;Device dependent I/O function codes 


«MACRO QIOSYS ARG,ARG1,ARG2 ;Reclaim macro storage 
~-ENDM QIOSYS 

e-ENDC 

~-ENDM QIoOsyYs$ 
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Defines the QIO 
devices. 


.MACRO SPCIOS SSSGBL 
-MCALL .WORD.,DEFINS 


-IF IDN,<SSSGBL>,<DEFS$G> 


..-GBL=1 
-IFF 
.« -GBL=0 
-ENDC 


function 
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codes that are specific to individual 


QIO Function Codes for Specific Device Dependent Functions 


-WORD. IO.WLV,100,001 
~WORD. IO.WLS,010,001 
~WORD. IO.WNS,020,001 
«WORD. IO.WAL,010,001 
«WORD. IO.WMS,020,001 
-WORD. I0.CCO,040,001 
-WORD. IO.WBT,100,001 
«WORD. IO.WLT,010,001 
~WORD. IO.WLC,020,001 
«WORD. IO.WPB,040,001 
-WORD. IO.WDD,044,001 


-WORD. IO.RLV,100,002 
-WORD. IO.RST,001,002 
~WORD. IO.RAL,010,002 
-WORD. IO.RNE,020,002 
-WORD. IO.RNC,040,002 
-WORD. IO.RTM,200,002 
»WORD. IO.RDB,200 ,002 
-WORD. IO.RHD,010,002 
-WORD. IO.RNS,020,002 
~WORD. I0.CRC,040,002 
-WORD. IO.RPB,040,002 
-WORD. IO.ATA,010,003 
-WORD. I0.GTS,000,005 


.WORD. IO.R1C,000,005 
.WORD. IO.INL,000,005 
»WORD. I0.TRM,010,005 
.WORD. IO.RWD,000,005 
.WORD. IO.SPB,020,005 
-WORD. I0.SPF,040,005 
.WORD. IO.STC,100,005 
.WORD. I0.SEC,120,005 
.WORD. IO.RWU,140,005 
-WORD. I0.SMO,160,005 
.WORD. IO.HNG,000 ,006 
»WORD. IO.RBC,000 ,006 


-WORD. IO.MOD,000,006 
~-WORD. IO.HDX,010 ,006 
~WORD. IO.FDX,020 ,006 
«WORD. IO.SYN,040 ,006 
-WORD. IO.EOF,000,006 
»WORD. IO.RTC,000,007 
-WORD. I0.SA0,000,010 
-WORD. I0.SS0,000,011 
~WORD. IO.RPR,000,011 
-WORD. IO.MSO,000,012 


(DECTAPE) Write logical reverse 
(COMM.) Write preceded by syne train 
(COMM.) Write, no sync train 
(TTY) Write passing all characters 
(TTY) Write suppressible message 
(TTY) Write with cancel CONTROL-o 
(TTY) Write with breakthrough 
(DISK) Write last track on RK06 
(DISK) Write logical with write check 
(RX11 DISK) Write physical block 
(RX11 DISK) Write physical with 

; deleted data 
; (MAGTAPE,DECTAPE) Read reverse 
(TTY) Read with special terminator 
(TTY) Read passing all characters 
(TTY) Read without echo 
(TTY) Read ~ no lower case convert 
(TTY) Read with time out 
(CARD READER) Read binary mode 
(COMM.) Read, strip sync 
( 
( 
( 
( 
( 


a 
q 
e 
? 
e 
’ 
e 
? 
° 
a 
e 
' 
. 
f 
° 
, 
e 
f 
° 
, 
, 


COMM.) Read, do not strip syne 
COMM.) Read, do not clear CRC 
RX1l DISK) Read physical block 
TTY) Attach with ASTs 
TTY) Get terminal support 

: characteristics 
* (AFC,AD01,UDC) Read single channel 
;(COMM.) Initialization function 
; (COMM.) Termination function 
2 ( 
7 ( 


=e “™e@ “6 “6 “™SB Se NO MO Ne VE Ne NA 


MAGTAPE,DECTAPE) Rewind 

MAGTAPE) Space "N" blocks 

(MAGTAPE) Space "N" EOF marks 
; (MAGTAPE) Set characteristic 
; (MAGTAPE) Sense characteristic 
; (MAGTAPE,DECTAPE) Rewind and unload 
; (MAGTAPE) Mount & set characteristics 
; (TTY) Hangup dial-up line 
;Read multichannels (buffer 

; defines channels) 

(COMM.) Setmode function family 
(COMM.) Set unit half duplex 
(COMM.) Set unit full duplex 
(COMM.) Specify sync character 
( 
R 


=e Se Ne Ne SO 


MAGTAPE) Write EOF 
ead channel - time based 


~e Ne 


(UDC) Single channel analog output 
(UDC) Single shot, single point 
( 
( 


™e Ne 


; (TTY) Read with prompt 
UDC) Single shot, multi-point 


ue 
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~WORD. I0.SLO,000,013 : (UDC) Latching, single point 
»~WORD. IO.MLO,000,014 + (UDC) Latching, multi-point 
~WORD. IO.LED,000,024 :(LPS11) Write LED display lights 
»-WORD. I0.SD0,000,025 ;(LPS11) Write digital output register 
-WORD. IO.SDI,000,026 ;(LPS11) Read digital input register 
»WORD. IO0.S5CS,000,026 ; (UDC) Contact sense, single point 
»-WORD. IO.REL,000 ,027 ;(LPS11) Write relay 
»WORD. IO.MCS,000 ,027 ;(UDC) Contact sense, multi-point 
»-WORD. IO.ADS,000,030 :(LPS11) Synchronous A/D sampling 
~WORD. IO.CCI,000,030 : (UDC) Contact int - connect 
-WORD. IO.MDI,000,031 ;(LPS11) Synchronous digital input 
~-WORD. IO0.DCI,000,031 + (UDC) Contact int - disconnect 
»-WORD. IO.XMT,000,031 ;(COMM.) Transmit specified block 

s with ACK 
WORD. IO.XNA,010,031 + (COMM.) Transmit without ACK 
-WORD. IO.HIS,000,032 ;(LPS11) Synchronous histogram 

; sampling 
»-WORD. IO.RCI,000 ,032 ; (UDC) Contact int - read 
»-WORD. IO.RCV,000,032 » (COMM.) Receive data in buffer 

; specified 
-WORD. IO0.MDO,000 ,033 ;(LPS11) Synchronous digital output 
»~WORD. IO.CTI,000,033 ; (UDC) Timer - connect 
»-WORD. IO.CON,000 ,033 ; (COMM.) Connect function 

;(VT11) - Connect task to display 

; processor 
»-WORD. IO.CPR,010,033 ; (COMM.) Connect no timeouts 
WORD. IO.CAS,020,033 2 (COMM.) Connect with AST 
»WORD. IO.CRJ,040 ,033 ; (COMM.) Connect reject 
WORD. I0.CBO,110,033 3 (COMM.) Boot connect 
-WORD. IO.CTR,210 ,033 ;(COMM.) Transparent connect 
»-WORD. IO.GNI,010,035 ; (COMM.) Get node information 
»~WORD. IO.GLI,020,035 ;(COMM.) Get link information 
»~WORD. I10.GLC,030,035 : (COMM.) Get link information - 

; clear counters 
»-WORD. IO.GRI,040,035 + (COMM.) Get remote node information 
»-WORD. IO.GRC,050,035 ; (COMM.) Get remote node error counts 
»-WORD. IO.GRN,060,035 ; (COMM.) Get remote node name 
«WORD. I0.CSM,070,035 > (COMM.) Change solo mode 
-WORD. IO.CIN,100,035 ; (COMM.) Change connection inhibit 
-WORD. I0.SPW,110,035 ; (COMM.) Specify network password 
-WORD. IO.CPW,120,035 + (COMM.) Check network password. 
»~WORD. IO.NLB,130,035 ; (COMM.) NSP loopback 
-WORD. I0.DLB,140,035 ; (COMM.) DDCMP loopback 
»WORD. I0.STD,000 ,033 +(LPA11) Start data transfer 
WORD. IO.DTI,000 ,034 3 (UDC) Timer - disconnect 
WORD. IO.DIS,000 ,034 + (COMM.) Disconnect function 

;(VT11L) - Disconnect task from 

; display processor 
-WORD. IO.MDA,000 ,034 ;(LPS11) Synchronous D/A output 
WORD. IO.RTI,000,035 ; (UDC) Timer - read 


»-WORD. IO.CTL,000,035 ; (COMM.) Network control function 
-WORD. IO.STP,000,035 ;(LPS11) Stop in progress function 

;(VT11) - Stop display processor 
»-WORD. IO.CNT,000 ,036 : (VT11) - Continue display processor 
»-WORD. IO.ITI,000 ,036 ; (UDC) Timer - initialize 


ICS/ICR QIO Functions 


»-WORD. IO.CTY,000,007 sConnect to terminal interrupts 
»-WORD. IO.DTY,000,015 ‘Disconnect from terminal interrupts 
»-WORD. IO.LDI,000,016 ‘Link to digital interrupts 

»-WORD. IO.UDI,010,023 sUnlink from digital interrupts 
~-WORD. IO.LTI,000,017 +Link to counter module interrupts 
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-WORD. 


-WORD. 
»~WORD. 


-WORD. 
-WORD. 
-WORD. 
» WORD. 
»WORD. 
»WORD. 


IP1l1 1/0 


-WORD. 
-WORD. 
-WORD. 
~WORD. 
»WORD. 
»WORD. 
-WORD. 
- WORD. 
-WORD. 
- MACRO 


IO.UTI ,020 ,023 


IO.LTY,000 ,020 
IO0.UTY ,030,023 


IO.LKE,000 ,024 
IO.UER,040 ,023 
IO.NLK ,000 ,023 
IO.ONL ,000 ,037 
IO.FLN,000,025 
IO.RAD,000,021 


Functions 


IO.MAO ,010 ,007 
IO.LEI,010,017 
IO.RDD,010 ,020 
IO.RMT,020 ,020 
IO.LSI,000,022 
IO.UEI,050 ,023 
I0.USI,060 ,023 
IO.CSI,000 ,026 
IO.DSI,000 ,027 
SPCIOS A 


-ENDM SPCIOS 
-ENDM SPCIO$ 


C.9.8 


Defines the I/0 
functions are implemented as a subfunction of I/O code 10 (octal). 


",MACRO 
.MCALL 


UMDIO$ Macro 


codes 


UMDIO$S S$$SGBL 
«WORD. ,DEFINS 


for 


MACRO EXPANSIONS 


;Unlink from counter module 

; interrupts 

;Link to remote terminal interrupts 
;Unlink from remote terminal 
; interrupts 

;Link to error interrupts 
:Unlink from error interrupts 
;Unlink from all interrupts 
sUnit online 

sUnit offline 

;Read activating data 


;Multiple analog outputs 

;Link event flags to interrupt 
sRead digital data 

;Read mapping table 

;Link to DSI interrupts 

s;Unlink event flags 

;Unlink from DSI interrupts 
;Connect to DSI interrupts 
;Disconnect from DSI interrupts 


user-mode diagnositcs. All 


.IF IDN <SSSGBL>,<DEFSG> 


.. GBL=1 
-IFF 

. + -GBL=0 
-ENDC 


General User-mode Qualifier Bit 


-WORD. 


IQ.UMD ,004,000 


;User mode diagnostic request 


User-mode Diagnostic Functions. 


-WORD. 
~WORD. 
~WORD. 
» WORD. 
»WORD. 
»WORD. 
-WORD. 
~WORD. 
-WORD. 


»WORD. 


IO.HMS ,000,010 
IO.BLS,010,010 
IO.OFF,020,010 
IO.RDH,030,010 
IO.WDH,040 ,010 
IO.WCK,050 ,010 
IO.RNF,060,010 
IO.RNR,070,010 
IO.LPC,100,010 


IO.ERS,110,010 


Home seek or recalibrate 
Block seek 

Offset position 

Read disk header 

Write disk header 

DISK) Writecheck (non-transfer) 
DECTAPE) Read block number forward 
DECTAPE) Read block number reverse 
MAGTAPE) Read longitudinal parity 
character 

(MAGTAPE) Erase tape 


Macro Redefinition to Null 


- MACRO 


UMDIOS A 


diagnostic 


»ENDM 
»ENDM UMDIO$ 
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MACRO EXPANSIONS 


C.9.9  .WORD. Macro 


This macro defines the symbol SYM where LO is the low order byte and 
HI is the high byte. 


-MACRO .WORD. SYM,LO,HI 
DEFINS SYM,<°O<HI*400+LO>> 
-ENDM .WORD., 


C.10 SNAP CONTROL BLOCK AND SNAPSHOT DUMP MACROS 


The following macros are the macros for the snapshot dump debugging 
aid. 


C.10.1 SNAP$ Macro 
SNAPS requests a snpashot dump. 


.MACRO SNAPS CTL,EFN,ID,l1,H1,L2,H2,L3,H3,L4,H4,?LBLI1,?LBL2 
.-MCALL SNPDFS ,WTSESS,SDATSS ,ROSTSS,CLEFSS 
SNPDFS 
-IIF NB <CTL>, MOV CTL,.,.SPBK+SB.CTL 
-LIF NB <EFN>, MOV EFN,..SPBK+SEB.EFN 
-IIF NB <ID>, MOV ID,..SPBK+SB.ID 
-»-SNP = SB.LM1 
-IRP X,<L1,H1,L2,H2,L3,H3,L4,H4> 
~IF NB <X> 
MOV X,..SPBK+...SNP 
-ENDC 
».-SNP = ...SNP+2 
»ENDM 
CLEFSS ..SPBK+SB.EFN ;Clear event flag 
BCS LBL2 
SDATSS #..SPBK+SB.PMD,#..SPBK ;Send snap information 
BCS LBL2 
RQSTSS #..SPBK+SB.PMD ;Request task "PMD..." 
BCC LBL1 
CMP #IE.ACT,@#SDSW ;0.K. if task already 
jyactive 
BEQ LBL1 
SEC 
BR LBL2 
LBL1 : WISESS ..SPBK+SB.EIFN ;Wait for snapshot to 
;finish 
LBL2: 
~-ENDM SNAPS 


C.10.2 SNPBKS Macro 
SNPBK$ generates a snap control block. 

-MACRO SNPBKS DEV,UNIT,CTL,EFN,ID,L1,H1,L2,H2,L3,H3,L4,H4 
SNPBKS never generates more than one block. 

IF DF ..SPBK 


-IIF NE <..SPBK-.>, .«MEXIT 
» ENDC 
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MACRO EXPANSIONS 


-MCALL SNPDFS$ 
SNPDF$ 


The following code builds the control block. 


. SPBK::.WORD CTL Control word 
-ASCII /DEV/ Send out device name 
IF NE .~<..SPBK+SB.DEV+2> 
» ERROR sInvalid device name "DEV" 
~-MEXIT 
~ENDC 
-BYTE UNIT,0 ;Device unit number & unused 
~WORD EFN ;Event flag number 
~WORD ID ;Snapshot identification word 
-WORD L1,H1 ;Dump address limits 
»~WORD L2,H2 
WORD L3,H3 
»-WORD L4,H4 
~RAD50 /PMD.../ ;Snapshot task name 


»-ENDM SNPBKS$ 


C.10.3 SNPDFS Macro — 
SNPDF$ generates snap offset and bit definitions. 


-MACRO SNPDFS GBL 

-IF IDN <GBL>,<DEFS$G> 

.GLOBL SB.CTL,SB.DEV,SB.UNT,SB.EFN,SB.ID,SB.LM1,SB.PMD 
.GLOBL SC.HDR,SC.LUN,SC.OVL,SC.STK,SC.WRD,SC.BYT 

»ENDC 


C.1l1 STATE AND KEYWORD TABLE GENERATION MACROS 


These macros initialize table generation - they are called once at the 
Start of each finite state machine description. The user must supply 
labels for the state and keyword tables. 


C.11.1 ISTATS Macro 


»MACRO ISTATS STTBL,KEYTBL 
-MCALL MTRANS 
-IF DF SRONLY 
~-PSECT S$STATE,D,RO 
LFF 
»-PSECT SSTATE,D 
-ENDC 

STTBL:: 
-IF DF SRONLY 
»-PSECT SKTAB,D,RO 
LFF 
-PSECT SKTAB,D 
-ENDC 

KEYTBL:: 
-IF DF SRONLY 
.PSECT SKSTR,D,RO 
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MACRO EXPANSIONS 


~IFF 

»PSECT SKSTR,D 
.» ENDC 

SSSKEY = -1 
SSSFLG = -1 
SEXIT = 0 
SLAMDA = 300 
SNUMBR = 302 
SSTRNG = 304 
SBLANK = 306 
SSUBXP = 310 
$EOS = 312 
SDNUMB = 314 
S$RAD50 = 316 
SANY = 320 
SALPHA = 322 
SDIGIT = 324 
-PSECT 


-ENDM ISTATS 


C.11.2 MTRANS Macro 
MTRANS sends out the last transition entry. 


-MACRO MTRANS 

-PSECT SSTATE 

~IF EQ $SS$FLG+1 

SSSFLG = 0 

.MEXIT 

-ENDC 

$$$TYP 

-BYTE SSSFLG 

-IF NE SSSFLG&1 

SSSEXT 

. ENDC 

-IF NE S$$$FLG&2 

SSSACT 

»ENDC 

-IF NE S$S$SFLG&10 

SS$SBIT 

- ENDC 

-IF NE SSSFLG&4 

eWORD SSSSTA 

IFF 

-IF EQ $SSFLG&200 

»~ERROR "BAD DEFAULT TRANSITION" 
.ENDC 

.ENDC 

SSSFLG = 0 

-ENDM MTRANS 

.LIST 


C.11.3 STATES Macro 
STATES declares a state. 
~MACRO STATES LABEL 

-PSECT SSTATE 


SSSFLG = $$$FLG!200 
MTRANS$ 
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MACRO EXPANSIONS 


.IF NB LABEL 
LABEL: .ENDC 

SSSFLG = -1 

»PSECT 

-ENDM STATES 


C.11.4 TRANS Macro 
TRANS specifies a state transition. 


.MACRO TRANS TYPE,LABEL,ACTION ,MASK,ADDR 
-PSECT SSTATE 
MTRANS 

.IF NB ACTION 
SSSFLG = $SSFLG!2 
«MACRO $SSACT 
»WORD ACTION 
»-ENDM $SSACT 
»ENDC 

-IF NB MASK 
SSSFLG = SSSFLG!30 
-IF B ADDR 

.ERROR "MASK ADDRESS NOT PRESENT" 
~ENDC 

»MACRO S$S$SBIT 
-WORD MASK,ADDR 
-ENDM S$S$BIT 
~ENDC 

.IF NB LABEL 
SSSFLG = SSS$FLG!4 
SSSSTA = LABEL 
.ENDC 

~IRPC X,<TYPE> 
.IF IDN <X>,<"> 
.PSECT S$KSTR 
SSSTMP = . 

»ASCII TYPE<377> 
-PSECT $KTAB 
-WORD SS$STMP 
-MACRO $S$S$TYP 
~-BYTE SSSKEY!200 
~-ENDM SSSTYP 
SSSKEY = S$SS$KEY+1 
-IF GT SSSKEY-63. 
»ERROR "TOO MANY KEYWORDS" 
.ENDC 

.MEXIT 

.ENDC 

.IF IDN <X>,<!> 
SSSFLG = S$SSFLG!1 
»MACRO SSSEXT 
.WORD O'TYPE 
»-ENDM SSSEXT 
-MACRO S$SSTYP 
.BYTE S$SUBXP 
-ENDM SSSTYP 
.MEXIT 

.ENDC 

».MACRO SSSTYP 
.BYTE TYPE 

-ENDM SSSTYP 
.MEXIT 
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MACRO EXPANSIONS 


»ENDM 
-PSECT 
-ENDM TRANS 


C.12 SUBMIT FILE TO PRINT SPOOLER (PRT...) MACRO (PRINTS) 


C.12.1 PRINTS Macro 

The PRINTS macro takes the following form: 
PRINTS FDB,ERR 

where: 


FDB=Address of the FDB of the file to submit. 
ERR=Address of error routine. 


- MACRO PRINTS FDB,ERR, ?LBL,A,B,C,D,E,F, ?LBL2 
-MCALL CALL,CLOSES ,LDRO$ ,GLUNSS 


LDROS FDB ;Load FDB address into R0 

TST F.BDB(RO) ;File open? 

BEQ LBL ;If eq no i 

MOV R1,-(SP) ;Save Rl] and R2 

MOV R2,-(SP) 

MOV R3,-(SP) ;Save R3 

MOV SP,R1 ;Save pointer to end of send buffer 
SUB #<8.*2>,SP ;Allocate a get LUN info buffer 
MOV SP,R2 ;Save its address in R2 

MOVB F.LUN(RO) ,R3 ;Get LUN in R3 

GLUNSS R3,R2 ;Get real device name and unit 
MOV G.LUCW(R2) ,R3 ;Save characteristics word l 
MOV RO,R2 ;Copy FDB address 

ADD #F.FNB+N.DID+6,R2 ;Point to end of directory ID 
MOV -(R2) ,-(R1) *Push directory ID 


MOV -(R2) ,~(R1) 

MOV -(R2) ,-(R1) 

ADD #N.FID+6-N.DID,R2 ;Point to end of file ID 

MOV -—(R2) ,-(R1L) ;Push file ID 

MOV -(R2) ,-(R1) 

MOV -(R2) ,-(R1) 

CLRB ~(R1) ;Clear LUN information flags byte 

ADD #N.FVER+2-N.FID,R2 ;Point to end of filename, type, 
; version 


MOV -(R2) ,-(SP) s;Push file version number 
MOV -(R2) ,-(SP) ;Push file type 
MOV -(R2) ,-(SP) ;Push filename 


MOV -(R2) ,-(SP) 
MOV -(R2) ,-(SP) 


MOV SP,R1 ;Set pointer to send buffer 
CLOSES RO ;Close file 
BCS LBL2 :;Skip on error 
BIT #FD.REC!FD.OSP,R3 ;Record oriented or spooled device? 
BNE LBL2 ;If ne yes 
MOV RO,R2 ;Save FDB address 
MOV #RPRT,RO 7;Get "PRT" in RAD-50 
CALL SDSPAT ;Send data to ...PRT or PRT... 
MOV RO,F.ERR(R2) 7;Get return status 
MOV R2,R0 ;Restore FDB address 
LBL2: ROR RL ;Save carry 
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ADD #<13.*2>,S5P 


ROL Rl 


MOV (SP)+,R3 
MOV (SP)+,R2 
MOV (SP)+,R1 
-IF NB ERR 


BCC LBL 


CALL ERR 


»~ENDC 
LBL: 


~ENDM PRINTS 


MACRO EXPANSIONS 


Clean stack 
sRestore carry 
;Restore R3 

:;Restore Rl and R2 


sI£f CC okay 
:Call error routine 


s;Reference label 


C.13 SET/GET SYMBOL (TTSYM$) MACRO EXPANSIONS 


Ci aud 


TTSYM$ Macro 


The TTSYMS macro file is used by RSX-11D, IAS, and RSX-11M terminal 


drivers. 


number of the symbols in this file. 


However, 


symbols required for terminal SET and GET characteristics. 


.MACRO TTSYMS SSSGBL 


»-MCALL DEFINS 
«oe ~GBL=0 


.IF IDN,<$SSGBL>,<DEF$G> 


ee -GBL=1 


-ENDC 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


TC.WID,1. 
TC.LPP,2. 
TC.RSP,3. 
TC.XSP,4. 
TC.STB;) 5 
TC.ISL,6. 
TC.RAT,7. 
TC.TTP,3. 
TC.SCR,9. 
TC.SCP,10. 
TC.HFL,11. 
TC.VFL,12. 
TC..NGL. ,13 4 
TC.SFF,14. 
TC.<HEF, 15. 
TC.LVF,16. 
TC.HAT 17% 
TC .NST,18. 
TC.BSP,19. 
TC.ACR,20. 
TC.SMR,21. 
TC.SMP,22. 


TC.SMO,23. 
TC.CCF,24. 
TC.ALT,25. 
TC.IMG,26. 
TC .NKB,27. 
TC.NPR,28. 
TC.ESQ,29. 
TC.LCP,30. 


;Line width 

;Lines per page 

;Receiver speed 

;Transmitter speed 

;Two stop bits 

:Subline on interface 

;Read-ahead type 

;Terminal type 

;Script line 

;Scope 

;Horizontal fill requirement 

;Vertical fill 

;ASCII newline terminal 

;Simulate formfeed and vertab 

;HARDWARE FORMFEED AND VERTAB 

;LA36 vertical fill 

sHardware horizontal tab 

sNon-standard hardware tab 

;Hardware backspace 

sAutomatic carriage return required 

*Small character input enabled 

*Small character input required 
; (/lower case input) 

;Small character output enabled 

sCONTROL-C flushes type-ahead and read 

sAlternative ALTMODE recognition 

*IAS - messages inhibited 

:;No keyboard 

;No printer 

;Escape sequence recognition 

;Local copy line 
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RSX-11M terminal driver uses only a limited 
The TTSYMS$ macro defines all 


the 


MACRO EXPANSIONS 


DEFINS TC.PAR,31. ;Parity recognition/generation 
; required 

DEFINS TC.EPA,32. ;Even parity 

DEFINS TC.DLU,33. ;Dialup line 

DEFINS TC.BLK,34. Block mode terminal 


DEFINS TC.FRM,35. 7;Forms mode terminal 

DEFINS TC.HLD,36. ;Terminal hold mode 

DEFINS TC.TAP,37. ;lLow speed paper tape reader 
DEFINS TC.CEQ,38. compatible escape sequences 
DEFINS TC.NEC,39. terminal in no-echo mode 


DEFINS 
DEFINS 
DEFINS 


TC.SLV,40. 
TC.PRI,41. 
TC.UCO,42. 


; 

; 

; terminal in slave mode 
7 terminal is privileged 
;User characteristic 


0 
DEFINS TC.UC1,43. ;User characteristic l 
DEFINS TC.UC2,44. ;User characteristic 2 
DEFINS TC.UC3,45. ;User characteristic 3 
DEFINS TC.UC4,46. ;User characteristic 4 
DEFINS TC.UC5,47. ;User characteristic 5 
DEFINS TC.UC6,48. User characteristic 6 
DEFINS TC.UC7,49. ;User characteristic 7 
DEFINS TC.UC8,50. ;User characteristic 8 
DEFINS TC.UC9,51. ;User characteristic 9 


DEFINS 


TC.MAX,52. 


*This must be one greater 
+ than the highest value used 
+ for a symbol 


Set Characteristic Error Codes 


;Wrong characteristic name 


DEFINS SE.ICN,1l. 
DEFINS SE.FIX,2. ;Attempt to change fixed 
; Characteristic 
DEFINS SE.BIN,3. ;Wrong value for binary 
; Characteristic 
DEFINS SE.VAL,4. ;Wirong value for non-binary 
; characteristic 
DEFINS SE.TER,5. ;Wrong terminal type 
DEFINS SE.SPD,6. ;Wrong speed for interface 
DEFINS SE.SPL,7. ;Wrong split speed for interface 


DEFINS SE.PAR,8. 
DEFINS SE.LPR,9. 
DEFINS SE.NSC,10. 


;Wrong parity type for interface 
;Other wrong line parameters 
;Interface does not have settable 


characteristics 


DEFINS SE.UPN,11. ;No space to save default 
; characteristics 

DEFINS SE.NIH,12. ;Characteristic not assembled in 
: handler 


Subfunction Codes for the 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS$ 
DEFINS 
DEFINS 
DEFINS 


SF.SSC, 
SF.SMC, 
SF.RDF, 
SF.STT, 
SF.STS, 
SF.GSC, 
SF.GMC, 
SF.GAC, 
SF.SAC, 
SF.DEF, 


Speed Types 


DEFINS 
DEFINS 


s.0 ri 
§.50 ,2 


2400!020 
2400!040 
24001060 
2400!100 
2400!120 
2400!140 
2400!160 
2400!200 
2400!220 
010 


Set Characteristics Function 


;Set single characteristic 
;Set multiple characteristics 
;Restore default 

;Set terminal type 

;Set terminal type and speed 
;Get single characteristic 
;Get multiple characteristics 
7Get all characteristics 

;Set all characteristics 

;Set default characteristics 
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DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


Terminal 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS$ 
DEFINS 
DEFINS 


Bits for 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


$.75 ,3. 
S.100 ,4. 
§.110 ,5. 
S.134 ,6. 
§.150 ,7. 
§.200 ,8. 
§.300 ,9. 
$.600 ,10. 
§.1200,11. 
$.1800,12. 
§.2000,13. 
§.2400,14. 
§.3600,15. 
$.4800,16. 
§.7200,17. 
§.9600,18. 
S.EXTA,19. 
S.EXTB,20. 


Types 


T.UNKO,O. 
T.AS33,1. 
T.KS33 52. 
T.AS35,3. 
T.L30S,4. 
T.L30P,5. 
T.LA36,6. 
T.VT05,7. 
T.VT50,8. 
T.VT52,9. 
T.VT55,10. 
T.VT61,11. 
T.L180,12. 
T.SCRO,13. 
T.USRO,14. 


T.USR1,T.USRO+1 
T,USR2,T.USR1+1 
T.USR3,T.USR2+1 
T.USR4,T.USR3+1 


Return from 


F1.ACR,000001 
F1.BTW,000002 
F1.BUF,000004 
F1.UIA,000010 
F1.cco,000020 
F1.ESQ,000040 
F1.HLD,000100 
F1.LWC,000200 
F1.RNE,000400 
F1.RPR,001000 
F1.RST,002000 
F1.RUB,004000 
F1.SYN,010000 
F1.TRW,020000 
F1.UTB,040000 
F1.VBF,100000 
F2.SCH,000001 
F2.GCH,000002 
F2.DCH,000004 


"GET 


MACRO EXPANSIONS 


;Unknown (unspecified) 
;ASR33 

sKSR33 

*ASR35 

*LA30S 

; LA30P 

; LA36 

;VTO5 

7;VT50 

2VT52 

3VT55 

:VT6l 

:;LA180S 
;Script line 
;User terminal 
sUser terminal 
;User terminal 
;User terminal 
;User terminal 


& Wr © 


TERMINAL SUPPORT’ 


;Auto CR/LF on long lines 
;Break through write 
;Intermediate buffering 
;Unsolicited input ASTs 
;Cancel CONTROL-O on write 
;Escape sequence support 

;Hold screen support 

;Lower case conversion 

;Read no echo 

;Read with prompt 

+Read with special terminators 
*Scope rubouts 

3; XON/XOFF 

;Transparent read/write 
;Buffering in task buffer 
*EXEC buffers are variable length 
;Set characteristics 

;Get characteristics 
;Dump/restore characteristics 
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DEFINS F2.DKL,000010 
DEFINS F2.ALT,000020 
DEFINS F2.SFF,000040 


MACRO EXPANSIONS 


sHistorical 11D/IAS IO.KIL 
;ALTMODE is echoed 
:Formfeed can be simulated 


Subfunction Bits for Terminal Handler QIOs. 
Note: A complete list of terminal handler function and subfunction 


codes appears in this 


DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 


DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 
DEFINS 


-» MACRO 
-ENDM 


TF.RST,O01 


TF.BIN,002 
TF.RAL,010 
TF.RNE,020 
TF.RNC,040 


TF.XOF,100 
TF.TMO,200 
TF .WAL,010 
TF .WMS ,020 
TF.CCO,040 
TF .WBT,100 
TF.SYN,200 
TF.AST,010 
TF.ESQ,020 


TTSYMS A 


-ENDM TTSYMS 


=e “oe SE SO “NB “es Ne Ne TSH TS MO MO Ne Ne NO ONO 


appendix under QIOMAC. 


[IO.RLB/IO.RPR] Read with special 


[IO.WLB] 


[IO.ATT] 


terminators 
Send prompt as PASS ALL 
Read pass all 
Read with no echo 
Read with no case 
conversion 
Send XOF after prompt 
Read with timeout 
Write pass all 
Write suppressible message 
Cancel CONTROL-O 
Break through read 
Synchronous write 
Specify ASTs in attach 
Recognise escape sequences 
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APPENDIX D 


LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 


D.1 LISTING OF CONDITIONAL ASSEMBLY PARAMETERS 
The following is a listing of all the conditional assembly parameters 


that are possible on the RSX-11M system. Many of these may not apply 
to your system but are listed here for your convenience. 


Parameter Definition 


ASSCHK 


s;Address checking 


ASSCPS ;ACP support 

ASS$DO1 ;AD01-D A/D convertors 

ASSF11 ;AFC11l A/D convertors 

ASSNSI ;ANSI magtape support 

ASSPRI +ALTER PRIORITY directive 

AS$R11 :AR11 laboratory peripheral systems 
ASSRDA ;AR11 D/A option 

ASSTRP ;AST support 

BSS$OOT ;Bootstrap ROM address 

C$$CKP ;Checkpointing support 

CSSINT ;Connect interrupt vector support 
CSSLIS ;Command language interpreter support 
CSSORE :Size of dynamic storage region 
CS$SOVL ;Overlaid network ACP 

CS$$R11 :CR11 card readers 

CS$RSH :Crash reporting 

C$$RUN ;Crash unit number 

DSSBl1l ;DAl11-B parallel line interfaces 
DS$SSBUG :Panic dump routine 

DSSE11 ;DLI1-E line interfaces 

DSSH11 ;DH11 asynchronous line multiplexers 
DSSIAG ;User mode diagnostics 

DSSISK ;Nonresident task support 

D$$J1l ;DJ11 asynchronous line multiplexers 
DSSL11 ;DL11/A/B/C/D line interfaces 

DSS$M11 *DM11BB modem control interfaces 
DS$P1l *;DP1l line interfaces 

DS$Qlil *DQ11 synchronous line interfaces 
DSSSHF sAutomatic dynamic memory compaction 
DSSU1I1 :DU11 line interfaces 

D$$wil ;DUP11 line interfaces 

DSSYNC ;Dynamic checkpoint allocation 
DSSYNM ;Dynamic memory allocation support 
DS$zZ1l ;DZ11 asynchronous line multiplexers 
DS$ZMD :DZ11 modem support 

ESSDVC ;Log device errors and timeout 
ESSEAE ;EAE support 

ESSNSI sLog undefined interrupts 

ESSPER ;Log parity error traps 
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Parameter 


ESSXPR 
FSSAST 
FSSLPP 
FSSLTP 
FSSLVL 
GS$$TPP 
GS$S$TSS 
GSSTTK 
GSSWRD 
I$$cll 
ISSCAD 
ISSCDA 
ISSCDS 
ISSCIM 
ISSCLK 
ISSCLT 
I$$CR 

ISSCRS 
I$$css 
I$SctTiI 
ISSCWD 
I$$Gll 
ISSRAR 
ISSRDN 
I$$sll 
ISSSDR 
ISSSDS 
ISSSLK 
ISSSPW 
ISSSRC 
ISSSSC 
KSSCNT 
KSSCSR 
KSS$G11 
KSS$LDC 
KSSTPS 
KSSwll 
LSS11R 
LS$S$50H 
LSSASG 
LSSDRV 
LSS$P11l 
L$SPsl 
LSSSBF 
LSSSDA 
LSSSDR 
LSSSGR 
LSS$SIl 
LDSAD 

LDSAF 

LDSAR 

LDSCR 

LDSCT 

LDSDB 

LDSDF 

LDSDK 

LDSDM 

LDSDP 

LDSDS 

LDSDT 

LDS$DX 

LDS$LP 
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Definition 


EXTEND PARTITION (task) directive 
;Asynchronous FPP 


-;Floating point processor support 


7FIS support 

7File structure level support 

+;GET PARTITION PARAMETERS directive 
7;GET SENSE SWITCHES directive 

;GET TASK PARAMETERS directive 
Include S$GTWRD code 

;ICS/ICR-11 industrial control subsystems 
7ICS/ICR-11 A/D convertor modules 
;ICS/ICR-11 D/A modules 

;ICS/ICR-11 digital sense input modules 
;ICS/ICR-11 digital interrupt modules 
;ICS/ICR-11 task activation from interrupts 
;ICS/ICR-11 bi-stable output modules 
;ICR-11 remote units 

;ICS/ICR-11 status recovery 
7ICS/ICR-11 single shot output modules 
;ICS/ICR-11 I/O counter modules 
;ICS/ICR-11 error count 

;KG11 CRC ootion 

;Install, request, and remove on exit 
7;I/O rundown 

;DRS/DSS-11 input/output modules 
;DRS-11 output modules 

;DSS-11 input modules 

;Task activation from interrupts 
;DRS-11l status restore on power recovery 
+;DRS-11 command register address 
;DSS-11 command register address 
;Count register address 

;Programmable clock CSR address 

;KG11 CRC option 

;Load count value 

;Ticks per second 

7KW11-Y support 

;Fast printer support 

750HZ line frequency 

;Logical device assignment support 
;Loadable driver support 
;LP/LS/LV11/LA180 line printers 
;LPS11 laboratory peripheral systems 
;LPS11 bandwidth filtering 

;LPS11 D/A option 

;LPSDR-A present 

;LPS11 gain ranging option 

;LSI-11 processor 

;Loadable ADDRV 

;Loadable AFDRV 

;Loadable ARDRV 

;Loadable CRDRV 

;Loadable CTDRV 

;Loadable DBDRV 

;Loadable DFDRV 

;Loadable DKDRV 

;Loadable DMDRV 

;Loadable DPDRV 

;Loadable DSDRV 

;Loadable DTDRV 

;Loadable DXDRV 

;Loadable LPDRV 


Parameter 


LDSLS 

LDSMM 

LDSMT 

LDS PP 

LDSPR 

LDSTT 

LDSXB 

LDSXL 

LDS XM 

LDS$XP 

LDSXQ 

LDS XU 

LDS XW 

M$ SCRX 
MSSCRB 
MSSEXT 
MSSFCS 
MSSIXD 
MSSMGE 
MSSMUP 
MSSNET 
MSSOVR 
NSSCON 
NSSMOV 
NSSMXM 
NSSTMO 
PSSD70 
PSSGMX 
PSSLAS 
PSSP1l 
PSSP45 
PSSR11 
PSSRFL 
PSSRTY 
PSSSRF 
PSSTPT 
PSSWRD 
QSS$CRC 
QSSHPT 
QSSOPT 
RSS$115S 
RSS11M 
R$$611 
RSS60F 
RSS6WC 
RSSDER 
RSSEXV 
R$SSF11 
RSSJPO 
RSSJS1l 
RSSJP1 
RSS$Kil 
R$ SKWC 
RSS$LOD 
RSSNDC 
RSSLKL 
RSSNDH 
RSSNDL 
RS$P1l1 
RSSSND 
RS$X1ll 
SSSECC 
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Definition 


*Loadable LSDRV 

;Loadable MMDRV 

;Loadable MTDRV 

;Loadable PPDRV 

;Loadable PRDRV 

;Loadable TTDRV 

;Loadable XBDRV 

;Loadable XLDRV 

;Loadable XMDRV 

;Loadable XPDRV 

;Loadable XQDRV 

;Loadable XUDRV 

;Loadable XWDRV 

;External MCR functions 

;MCR command buffer length 

311/70 extended memory support 
:;FCS/file system support 

;Mixed RH11 drive types 

;Memory management 

Multi-user protection 

sNetwork ACP support 

;Overlayed MCR 

sNumber of simultaneous logical channels 
:Size of BLXIO 'MOV' table 

;Maximum network data message size 
sNetwork control message timeout period 
311/70 cache parity support 

:Get mapping context 

;Program logical address extensions 
;PC1ll paper tape punch 

;Rotating data lights 

;PR11 paper tape reader 

;Powerfail recovery 

;Parity memory 

*;SEND/RECEIVE by REFERENCE 
;Point-to-point network support 
;Include $PTWRD code 

:DQ11 CRC option support 

+DQ11 protocol option support 
;Pre-allocate I/O packets 

+;RSX-11S system 

;RSX-11M system 

+RK611 disk cartridge controllers 
>RKO6 offset recovery support 
*RK611 write check support 

*CORAL deallocation error checking 
;Extend Executive to 20k 

;RF11 fixed head disk controllers 
;Offset recovery support 
;RI/RWS03-04 fixed head disk controllers 
+RJ/RWP04-05-06 disk pack controllers 
+RK11 cartridge disk controllers 
;RK11 write check support 

;Remote task loading 

*Clock ticks per scheduling interval 
*RMS-11 block locking 

;Highest priority class to consider 
sLowest priority class 

;RP11-C/E disk pack controllers 
>SEND/RECEIVE directives 

;RX11 disk controllers 

;Shared Executive ECC code 


Parameter 


SSSWPC 
SSSWPR 
SSSWRG 
S$S$yYSsz 
T$$18s 
TSS30P 
TSSA11 
TSSACR 
TSSBIW 
TSSBUF 
TSSC11 
TSSCCA 
TSSCCO 
TSSCTR 
TSSESC 
TSSGMC 
TSSGTS 
TSSHLD 
TSSJ16 
TSSKMG 
TSSLWC 
TSSM11 
TSSMAN 
TSSMIN 
TSSRNE 
TSSRPR 
TSSRST 
TSSRUB 
TSSSMC 
TSSSYN 
TSSTRW 
TSSUTB 
TSSVBF 
TS$ZAN 
USSACH 
USSADM 
USSAOM 
USSCIM 
USSCSM 
USSD1l 
USSLTM 
USSMHI 
US$MLO 
USSMRN 
USSNIP 
USSSSM 
USSTIM 
VSSCTR 
V$$s2s 
V$$s60 
VSST11 
XSSDBT 
X$SM11 
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Definition 


;Clock ticks per swapping interval 
;Swapping priority 

;Console switch register present 
;Size of physical memory in 32W blocks 
7;LA180S support 

;LA30P support 

;TA1l1 dual cassettes 

;Automatic CR/LF 

;Breakthrough write 

;Terminal input checkpointing 

7TCll DECtape controllers 
;Unsolicited input AST 

;Write with control-O cancellation 
;Control-R support 

;ESscape sequence support 

;Get terminal characteristics 

;Get terminal driver support 
+;Hold-screen support : 
;TI/TWU16--45 magtape controllers 
;Task termination/device not ready messages 
iSettable case conversion (lower case) 
;TM/TMA/TMB11 magtape controllers 
;DM11BB answer baud rate 

;Baseline terminal driver 

;Read with no echo — 

;Read with prompt or after prompt 
;Read with special terminator 

7;CRT rubout 

;Set terminal characteristics 
;Terminal~-host synchronization support 
;Transparent terminal read/write 
;User terminal input buffering 
;Variable length terminal input buffers 
7DZ11 answer baud rate 

;Number of channels per module 

;ADUO] or IAD-IA module description 
;Analog output modules 

;Digital interrupt module description 
;Digital sense intput module 

;UDC11 Universal digital controller 
;Bi-stable output module description 
;High part of UNIBUS address 

;Low part of UNIBUS address 

;Address of next available UMR 
;Uni-polar A/D sampling 

;Single-shot output modules 

;1/O counter module description 
;Address of highest vector plus 4 
;VS60 drives two CRT monitors 

;VS60 graphics display subsystem 
;VT11 graphics display subsystem 
;Executive debugging tool 

*;DMC11 line interfaces 


APPENDIX E 


GENERAL FAULT ISOLATION 


E.1 INTRODUCTION 
This Appendix is a guide containing some general hints about fault 
isolation in the RSX-11M system. It is not an all-inclusive guide, 
but it does offer suggestions to get you started in the right 
direction. Other aids that may help you: 

@ RSX-11M Crash Dump Analyzer Manual 


® IAS/RSX-11 ODT Reference Manual (for the Online Debugging 
Tool) 


e RSX-11M User Mode Diagnostics Reference Manual 


e Executive Debug Tool (XDT) and Panic Dump, described in the 
RSX-11M Guide to Writing an I/O Driver 


@e RSX-11M Task Builder Reference Manual (for Post Mortem and 
Snapshot Dumps) 


E.2 FAULT CLASSIFICATIONS 
Four possible causes can be identified when the system faults: 


1. A user-state task has faulted such that it causes the system 
to fault (unmapped systems only) 


2. A user-written driver has faulted such that it causes the 
system to fault 


3. The RSX-11M system software itself has faulted 

4. The host hardware has faulted. 
You should immediately determine which of these four cases is the 
source of the fault. This section outlines the procedures that may 


help you to uncover the source of the fault. Correcting the fault is 
assumed to be your responsibility. 


E.3 SERVICING FAULTS 


Faults manifest themselves in roughly four ways. They are listed here 
in the order of increasing difficulty of isolation. 
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1. If XDT is included in your system, an unintended trap to xXDT 
occurs. 


2. The system displavs text indicating a crash has occurred and 
halts. 


3. The system halts but displays nothing. 


4, The system is in an unintended loop. 


Regardless of fault manifestation, you should immediately obtain 
pertinent fault isolation data. 


Case 1--The system has trapped to XDT 


The trap may or may not be intended (for example, you may not have 
removed a previously set breakpoint). If the trap is not intended, 
type the X command. This causes XDT to jump to location 40(8), from 
which the Executive stack and register dump routine (if present), 
followed by either Panic Dump or the Crash Dump Analyzer (CDA) support 
routine (if present), will be invoked. If, however, you have some 
idea of the source of the problem (for example, a recent coding 
change), then you can use XDT to examine pertinent data structures and 
code. 


Case 2 - The system has displayed text indicating a crash occurred 
If the text consists of output from the Executive stack and register 
dump routine, all the basic information describing the state of the 


system has been displayed. If the text has been produced by the CDA 
support routine, follow the procedure for obtaining and formatting a 


memory dump as outlined in the RSX-11M Crash Dump Analyzer Reference 


Manual, 


Case 3--The system has halted but displays no information 


Before taking any action, examine and record the following 
information: 


@ Current PS and PC 

e General registers 

e Executive stackpointer and stack 
e Executive PARS on a mapped system 
@ Pertinent device registers 


The procedure depends on the particular PDP-11 processor. Consult the 
appropriate PDP-11 Processor Handbook for details. 


After preserving the PS and PC, invoke your resident debugging aid: 
enter 40(8) in the switch register, press LOAD ADDR, and then press 
START. The contents of 40(8) cause the successive invocation of: 

1. The Executive stack and register dump routine (if present) 


2, Either Panic Dump or CDA support routine (if present) 
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Case 4 - System is in an unintended loop 


Proceed as follows: 


1. Halt the processor 


2. Record PC and PS and any pertinent device registers, as in 
Case 3 above. 


You may then want to step through a number of instructions in an 
attempt to locate the loop. For this attempt to be meaningful you 
must first disable the system clock. Proceed as follows: 


1. Examine the contents of word 777546 (if your system has a 
line frequency clock) or word 772540 (if it has a 
programmable clock). 


2. Clear bit 6 in this word and redeposit the word. This 
disables the clock. 


3. The system will not run unless you reenable the clock. 


4, After trying to locate the loop and reenabling the clock, 
transfer to location 40(8) as in Case 3. 


E.3.1 Gathering Pertinent Fault Isolation Data 


Before proceeding with locating the fault, you should to dump the 
system common (SYSCM). SYSCM contains a number of critical pointers 
and listheads. Find the file SYSCM in the Executive memory allocation 
map listing, then enter the appropriate limits into the Panic Dump 
Routine. 


Alternately, you can run the Crash Dump Analyzer as a task; or, -1£ 
XDT is included in your system and a program condition causes a 
processor trap, control transfers automatically to XDT and typing X at 
your terminal causes control to be transfered to the crash dump 
routine. 
In addition, you should to dump the Dynamic Storage Region and _ the 
device tables. The Dynamic Storage Region starts in the module INITL 
and the device tables are in SYSTB. 
At this point, you have the following data: 

e PS 

e@ PC 

e The stack 


e RO through R6 
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@ The Dynamic Storage Region 
@e The Device Tables 
® System common 


These data are the minimum required to trace the fault effectively. 
E.3.2 Tracing Faults 


Three pointers in SYSCM are critical in fault tracing. 
are described below: 


These pointers 


SSTKDP - Stack Depth Indicator 


This data item indicates which stack was being used at the time 


of the crash. $STKDP plays an important role in determining the 
origin of a fault. The following values apply. 
+] -- User (task-state) stack 
0 -- System stack (system processing) 
-l1 -- Interrupt processing only 
STKTCB - Pointer to the Current Task Control Block (TCB) 
The current TCB is the TCB of the user-level task in control of 
SHEADR - Pointer to the Current Task Header 
The $HEADR word points to the header of the task currently 
running. The task header provides additional data to help 
isolate the fault. Figures E-1 and E-2 show the layout of task 
headers for unmapped and mapped systems. 
The first word in the header is the user task's stack pointer 
(SP) the last time it was saved. If the user task branches 
wildly into the Executive, the Executive terminates the user 
task, but the system continues to function (possibly erroneously 
on an unmapped system). On a mapped system, only a privileged 
task can enter and corrupt the Executive. Knowing the user 


task's stack pointer provides one more link in the chain that may 
lead to the resolution of the fault. 


The header (as pointed to by SHEADR) also contains the last-saved 
register set, just before the header guard word (the last word in 
the header, pointed to by H.GARD). 
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LENGTH IN BYTES 


.Figure E-l Task Header on an Unmapped System 


H.HDLN | LENGTH IN BYTES 


Figure E-2 Task Header on a Mapped System 


E.3.2.1 Tracing Faults Using a Display of the Executive Stack and 
Registers - To trace a fault after a display of the Executive stack 
and register contents, first examine the system stack pointer. 
Usually an Executive failure is the result of an SST-type trap within 
the Executive. If an SST does occur within the Executive, the origin 
to the call on the crash reporting routine is in the SST service 
module. (The crash call is initiated by issuing an [oT at a stack 
depth of zero or less.) 
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A call to crash also occurs in the Directive Dispatcher when an EMT is 
issued at a stack depth of zero or less, or a trap instruction is 
executed at a depth of less than zero. The stack structure in the 
case of an internal SST fault is shown in Figure E-3. 


RETURN TO SYSTEM EXIT 


ZERO OR MORE SST PARAMETERS 


SST FAULT CODE 
NUMBER OF BYTES SP 


Figure E-3 Stack Structure: Internal SST Fault 


The fault codes are: 


0 Odd address and traps to 4 

2 Memory protect: violation 

4 Break point or trace trap 

6 IOT instruction 

10 Illegal or reserved instruction 
LZ Non-RSX EMT instruction 

14 Trap instruction 

16 11/40 floating point exception 
20 SST abort - bad stack 

22 AST abort - bad stack 

24 Abort via directive 

26 Task load read failure 

30 Task checkpoint read failure 
32 Task exit with outstanding 1/0 
34 Task memory parity error 


The PC points to the instruction following the one which caused the 
SST failure. The number of bytes is the number normally transferred 
to the user task's stack when the particular type of SST occurs. Te 
the number is 4, an abnormal SST fault occurred, and only the PS and 
PC are transferred. There are no SST parameters. 


If the failure is detected in S$DRDSP the stack is the same as that 
Shown in Figure E-3, except the number of bytes, the SST fault code 
(the fault codes are listed above), and the SST parameters are not 
present. The crash report message, however, will indicate that the 
failure occurred in SDRDSP. 
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One SST-type failure, stack underflow, does not result in the stack 
structure of Figure E-3. To determine where the crash occurred, first 
establish the stack structure; this can be deduced by the value of 
the SP and the contents of the top word on the stack. If the stack 
structure is that of Figure E-3, then the failure occurred in S$DRDSP, 
or was anormal SST crash. If the stack structure is that of Figure 
E-4, then an abnormal SST crash has occurred. 


—————— SP 


Figure E-~4 Stack Structure: Abnormal SST Fault 


Abnormal SST failures occur when it is not possible to push 
information on the stack without forcing another ssT fault. When this 
situation occurs, a direct jump to the crash reporting routine occurs 
rather than an IOT crash. The PS and PC on the stack are those of the 
actual crash, and the address printed out by the crash-reporting 
routine is the address of the fault rather than the address of the I0T 
that crashes the system. Note that the crash reporting routine 
removes the PC and PS of the IOT instruction from the stack, which in 
this case is incorrect. Thus, the SP appears to be 4 bytes greater 
than it really is (as in Figure E-4). 


You now have all the information needed to isolate the cause of the 
failure. 


E.3.2.2 Tracing Faults When the Processor Halts Without Display - To 
trace a fault when the processor halts but displays no information 
(Case 3 as described above), first examine S$STKDP, STKTCB, and $SHEADR. 
Tracing failures in this case is difficult because the system stack is 
not directly associated with the cause of a failure. 


By examining $STKDP, you can determine the system state at the time of 
the failure. If the system was in user state, examine the user task's 
stack. The examination focuses on scanning the stack for addresses 
that may be subroutine links that can ultimately lead to a thread of 
events isolating the fault. This is essentially the aim of looking at 
the system stack if $STKDP is zero or less. 


Frequently, a fault can occur that causes the SP to point to the Top 
of Stack (TOS)+4. This fault results from issuing an RTI when the top 
two items on the stack are data instead of the return address (PC) and 
processor status (PS) for the routine being returned to. A wild 
branch occurs followed, most probably, by a halt. 


Figure E-5 shows a case in which two data items are on the stack when 
the program executes an RTI. TOS points to a word containing 40100. 
This word will be the new PC. Suppose that location 40100 contains a 
halt. After the RTI and the halt occurs, the SP points four bytes 
above the previous location, and fault tracing should begin from the 
previous SP. 
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SP 
—t——— AFTER RT! 


§ 


—_ SP 
40100 ~t—————— BEFORE 
RTI 


Figure E-5 Stack Structure: Data Items on Stack 


This type of fault also occurs when an RTS instruction is executed 
with an inconsistent stack; that is, a stack with the wrong contents 
for the correct execution of the RTS instruction. The RTS instruction 
pops the top element off the stack. The top element of the stack 
becomes the new PC or occupies a register depending on the form of the 
RTS instruction. However, in any case, SP points to TOS+2 after an 
RTS instruction. as 


A scan of the contents of the general registers may give some hint as 
to the neighborhood in which a fault (or the seguence of events 
leading up to the fault) occurred. 


If the fault occurred in a new driver, the buffer address and count 
words in the UCB (U.BUF, U.BUF+2, U.CNT), and the activity flags 
(US.BSY and S.STS) are frequent sources of clues. Other locations in 
both the UCB and SCB may also provide information that may help locate 
the source of the fault. 


E.3.2.3 Tracing Faults After an Unintended Loop - To trace a fault 
when an unintended loop has occurred, first halt the processor. After 
you halt the processor, the same state exists as in tracing faults 
when the processor halts without display (as described above). Follow 
the same tracing procedure described there. A specific suggestion is 
to check for a stack overflow loop. Patterns of data successively 
duplicated on the stack indicate a looping failure. 


E.3.2.4 Additional Hints for Tracing Faults - 


E.3.2.5 I/O Packets - Another item to check is the current (or last) 
I/O packet, the address of which is found in S.PKT of the SCB. The 
packet function (I.FCN) defines the last activity performed on the 
unit. 


If trouble occurred in terminating an I/O request, a scan of the free 
block list for the system Dynamic Storage Region may provide some 
insight. This list starts at the address contained in S$CRAVL, a cell 
in SYSCM, Because all I/O packets are built in the system's Dynamic 
Storage Region, their memory is returned to the Dynamic Storage Region 
when they are successfully terminated. Following the link pointers in 
this region may reveal whether I/0 completion proceeded to that point. 
In systems with QIO optimization, $PKAVL (SYSCM) points to a list of 
I/O packet-sized blocks of dynamic memory that are not linked into the 
SCRAVL chain. Normally, the last completed I/O packet is the first in 
the SPKAVL list. 
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A freguent error for an interrupt-driven device is to terminate an I/O 
packet twice when the device is not properly disabled on I/O 
completion and an unexpected interrupt occurs. This action ultimately 
produces a double deallocation of the same packet of dynamic memory. 
Double deallocation of a dynamic buffer in RSX-1L1M causes a loop in 
the routine $DEACB (in the CORAL module) on the next deallocation (of 
a block of higher address) after the second deallocation of the same 
block. At that time, R2 and R3 both contain the address of the I/0 
packet memory that has been doubly deallocated. If XDT has been 
included in the system, the deallocation routine checks for bad 
deallocation and crashes the system if it occurs. Note, that queue 
I/O optimization, which employs pre-allocated I/O packets, may cause a 
double-deallocation error to get by. This may happen if the 1/0 
packet in question does not become deallocated and is put ina 
separate list. To avoid this, use the SET /MAXPKT=0 command to 
temporarily void the optimization. 


E.3.2.6 System Stack Pointer - Use the system stack pointer to find 
the current position of the system stack. The system stack will 
contain addresses or instructions of code that was being executed 
prior to the crash (this is only true if the $STKDP is less than 1). 
From this point, all call activity can be traced, with the help of the 
listings, back to the original $SWSTK or EMT377 call. 
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SYSTEM TUNING 


This appendix is a brief synopsis of ways to improve the performance 
of an RSX-11M system. There may be many conflicting trade-offs and 
requirements in your particular installation; therefore, some 
techniques may not be applicable to your situation. This appendix is 
not intended to be the last word in system tuning, but is written in 
the nature of a general approach to system tuning and contains some of 
the techniques and concepts you can use to improve performance. 


F.1 HARDWARE CONSIDERATIONS 


The most obvious approach to improving’ system performance is to 
upgrade the hardware to faster and/or larger capacity devices. If 
your applications make heavy demands upon CPU time, it makes sense to 
upgrade to a faster processor. If your application involves many disk 
transfers, more CPU memory may be needed to reduce the number of 
transfers or fixed head disks may be needed to reduce transfer time. 
Heavily overlaid tasks require many disk transfers. Tf this 
constantly occurs, more memory may allow fewer task overlays. The use 
of memory management directives instead of overlaid tasks could 
improve system performance in this case. Also, consider the use of 
resident overlays or multiple copies of FIl1ACP, one for each volume, 
if you must use overlaid tasks with high 1/0 requirements. However, 
resident overlays require more memory. 


F.2 MEMORY LAYOUT 


The memory layout of your particular system is an important factor 
that affects system throughput. The following procedures improve 
throughput: 


e If your CPU has enough memory, put the following system 
programs in separate partitions to avoid their checkpointing 
each other: 

MCR, FI1ACP, TKTN, SHUFFLER 


@ Load loadable drivers into special driver partitions to avoid 
fragmenting memory. 


e Arrange to have PLAS dynamic regions in their own special 
partitions. 
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F.3 EXECUTIVE SOFTWARE OPTIONS 


The options listed below are covered in detail in the RSX-11M System 
Generation Manual. The most important options that affect system 
performance include: 


Choice of FIIACP - If your memory is big enough, install 
BIGFCP as memory-resident to greatly improve disk access time. 
Install separate copies of F1l1ACP for each disk if file access 
is frequent and occurs to many different disks. .The /ACP 
switch in the Mount command selects the copy of FI11ACP for 
that particular disk. 


Dynamic checkpoint allocation on the fastest system disk on 
your system. 


Shuffling - The Shuffler, a nonresident privileged task for 
mapped systems compacts Memory in a system-controlled 
partition. This task minimizes memory fragmentation and 
provides better memory usage. The Shuffler is a SYSGEN 
option. 


Round-robin scheduling - Selection of the round-robin 
scheduling option during SYSGEN ensures that tasks in a range 
of priorities share the use of memory. This is important when 
many CPU-bound tasks within a specified range of priorities 
are running at the same time. 


Swapping - This SYSGEN option allows tasks to be checkpointed 
by tasks of equal priority when many tasks of equal priority 
are competing for memory. The checkpointing option is a 
pre-requisite. 


Memory management directives - Allows tasks to access a 
greater span of physical memory than their normal 32k 
addressing capability allows. 


Loadable device drivers - Loadable drivers may slow down I/O a 
bit, however, they occupy memory only when needed. 


Queue I/O speed optimizations - I/O throughput is increased at 
the expense of additional Executive code. Because of this 
option, I/O packets are pre-allocated, which makes’ them 
quickly available for QIOs. 


Install, request, and remove on exit support - This option 
conserves Dynamic Storage Region space by allowing tasks to be 
memory resident only when active, but does not increase 
throughput. 


Checkpointing on terminal input - This SYSGEN option allows 
more copies of terminal I/O-bound tasks to be run than 
normally could be run in a given amount of memory. 


Error logging - This option can be useful when information 
about system errors (device errors, timeouts, cache and memory 
parity errors) is needed. However, file space is needed for 
the records and this option automatically includes support for 
checkpointing and the Send/Receive directives. 


Size of dynamic storage region - It is possible to exhaust 
dynamic memory during the running of RSX-11M. This can occur 
if a large number of tasks are installed, if many volumes’ are 
mounted, or if a number of other conditions are present. This 
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problem can manifest itself in the lack of any response from 
the system. Although the system looks like it is operating 
successfully, it cannot accept any MCR commands or complete 
the execution of presently running tasks because they all 
require dynamic memory. Another manifestation of the problem 
may be I/O errors being received by tasks or failures in the 
Loader due to pool allocation failures. The only solution to 
this problem is to bootstrap the system and make more dynamic 
space available (SET /POOL), remove tasks, mount fewer 
volumes, rebuild FCP with space for more file control blocks 
in its partition, or rebuild the system with more dynamic 
memory. See the RSX-11M System Generation Manual for a 
complete and detailed discussion of dynamic memory - its uses 
and its users. 


VMR installable Loader task - The Loader task occupies 2200 (8) 
bytes and is one of the Executive tasks. Installing and 
fixing the Loader in its own partition releases the 2200 (8) 
bytes for use in the Dynamic Storage Region. 


F.4 FILE SYSTEM OPTIONS 


Many options of the INI and MOU commands can change performance. The 
more important options are: 


/EXT 


/INDX 


/LRU 


/WIN 


default extension block count - Unless this block count is 
specified, the file has a default block count of five, whether 
it uses all five blocks or not. If the default is used and the 
file is larger than five blocks, the file is not continuous and 
more accesses are required for the file. If the file uses less 
than five blocks, all five blocks are reserved for the file and 
no other file can use them. On the other hand, if you specify 
one as the block count, the file gets only the number of blocks 
it needs but it may require many accesses to access the whole 
file. To conserve space and reduce the number of file 
accesses, be as specific as possible about the number of blocks 
that your files need. 


index file position - The position of the index file in large 
volumes is important because of seek time. Rather than have 
the index file at the beginning or end of a volume, position 
it, either by block number or the MID key word, at the 
mid-point of the volume. In the case of small volumes, such as 
a floppy-disk, putting the index file at the mid-point will 
limit the maximum size of the work files on the disk. In this 
case, put the index file at the beginning or end of the volume. 


memory buffers to speed up directory searches - LRU specifies 
the number of 512-byte buffers to be maintained in memory. The 
buffers contain only the most recently accessed directories. 
The default is three buffers. If your application is working 
with a small number of directories, the defaults may be 
sufficient. However, if many directories are being scanned 
frequently, access time will improve if you specify a higher 
number than three. However, more buffers use more memory. 


mapping pointer count - WIN specifies the number of mapping 
pointers to be allocated for file windows. The default is 
seven pointers. The pointers point to contiguous blocks of the 
file on the disk. Access to fragmented files may be optimized 
by increasing the number of pointers. However, additional 
memory may be freed by reducing the number of pointers for 
files with little or no fragmentation. 


F=3 
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HELPFUL HINTS 


Avoid entering CTRL/C to explicitly request MCR. Typing 
CNTRL/C slows down response to other users needing MCR 
facilities, 


Use indirect command files to MAC and TKB whenever possible, 
especially if the commands are long. If you do this, MAC or 
TKB spend less time competing for resources. 


When task building or assembling large programs, insert all 
modules in a created library and specify each module by name. 
This reduces the number of times that TKB or MAC have to open 
files. 


If you are doing SYSGEN with a mapped baseline system and your 
system has enough memory, create a separate 32K partition and 
install PIP, BIGTKB, and BIGMAC in this partition; this 
shortens the time taken for SYSGEN. 


If you have the room, install BIGTKB and BIGMAC with a large 
/INC. This reduces the system overhead that TKB and MAC would 
cause when they executed Extend Task directives. 


Install PIP with an increment (/INC). In general, run 
utilities in the largest possible partition. 


If your system uses RMS, build the library modules as 
memory-resident. 


Use the following form, shown as an example, to call utilities 
whenever you want to use a utility once: 


>PIP command <CR> 


Using this form reduces the time that PIP (or any other 
utility) spends competing for the memory resource. However, 
if you intend to use a utility to perform multiple operations, 
use: 


>PIP 

PIP> command <CR> 
PIP> command <CR> 
PIP> command <CR> 


CTRL/2Z 

> 
Use the print spooler as much as_ possible. This avoids 
leaving utilities in memory while printing on the line 
printer. 


To save memory space by reducing task size, you may want to 
build a resident (sharable) library containing frequently-used 
FORTRAN routines. For the same reason, you may want to 
produce a position-independent library containing all the FCS 
modules required by a set of programs that are intended to run 
Simultaneously. FCSRES.MAC and FORRES.MAC files are provided 
on the distribution disk. Building a FORTRAN and FCS resident 
library is described in the RSX-11M System Generation Manual. 


Plan the overlay structure of your tasks. You may possibly 
achieve a large reduction in disk accesses by careful 
planning. 
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® Avoid putting all the files needed by an application in a 
single UIC. Having all files in a single UIC slows down 
directory searches as each block can hold 32 entries only (8 
words per entry). Many more disk accesses are required to 
search for the 300th file in a single UIC than the 30th file 
in the last of 10 UICs. 


® RMDEMO does add some overhead to the system's operation. ne oe 
is not necessary to run RMDEMO continously, only when the 
information that it supplies is required. However, if you do 
not run RMDEMO continuously, you may not be able to observe 
the system when a problem occurs (for example, dangerously low 
and decreasing pool space). 


F.6 SOME OUSEFOL COMMANDS 

There are four commands that can give you a description of your system 
that may be useful when you tune your system. They are the Tasklist, 
the Partition Definitions, the Task List, and the Active Task List 


commands. These commands are more fully described in the RSX-11M 
Operator's Procedures Manual. 


TASK LIST - Short Version 
The Tasklist command displays on _ the entering terminal a brief 
description of each installed task. The display contains, from left 
to right: 
1. Task name 
2. Task version identification 
3. Partition name 
4, Task priority 
5. Size of task in bytes (8) 
6. Load device identification 
7. Disk address logical block number (8) 
8. Task memory state 
Format: 
TAS 
Example: 
..eLDR 07.05 LDRPAR 248. 00002200 LBO:-01035303 FIXED 
TKTN 03.3 SYSPAR 248. 00010000 LBO:-01126742 
RMDEMO X03.03 GEN 225. 00013700 SY0:-00352100 
MTAACP 0006 GEN 200. 00013000 DS0:-00000777 


F11IMSG V0O010 GEN 200. 00005400 Sy0:-01053030 
..-MCR O1 GEN 160. 00025000 LBO:-01051676 


ETC. 


PARTITION DEFINITIONS 
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The Partition Definitions command displays on the entering terminal a 
description of each memory partition in the system. 


The display consists of five columns that specify (in order from left 


to right): 


1. Partition name 


2 Partition base 


3. Partition size 


4. Partition kind: 


5. Partition type 


address (8) 


(8) 


iain partition (MAIN) or subpartition (SUB) 


TASK for user-controlled 


COM for common 


DEV for device registers 
SYS for system-controlled 
Taskname for task region 


D 


..MIC for dynamically created region 


DRIVER for region occupied by a loadable driver 


Format: 


PAR 


Example: 


Name 
LDR 
SYSPAR 
FCPPAR 
PMDPAR 
SPLPAR 
DRVPAR 


GEN 


TASK LIST - Long Version 


Base 

000000 
120000 
130000 
156000 
156000 
176000 
176000 
177600 
200300 
201300 
202400 
203400 
212000 
212000 
225400 


Size 

000000 
010000 
026000 
020000 
010000 
014000 
001600 
000500 
003000 
001100 
002000 
003100 
546000 
013400 
045700 


ETC o 


The Task List command displays 
and status of 
installed task in the system. 


descriptions, 


Type 
MAIN 
MAIN 
MAIN 
MAIN 
SUB 
MAIN 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
MAIN 
SUB 
SUB 


on the 


TASK 
TASK 
TASK 
TASK 
TASK 

SYS 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
DRIVER - 
SYS 
(RMDEMO) 
(...EDI) 


entering 


all installed 


DB: 
DS: 
DK: 
DT: 
LP: 
MM: 


terminal the names, 
tasks or of a specific 
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The display contains, reading from left to right, the following 
information for each task: 

e Task name 

@e Task control block physical address (8) 

e Partition name 

@ Partition control block physical address (8) 

e Partition base and limit physical address (8) 

e Task's running priority and default priority 

e Task status flags 

e TI terminal physical device unit 

e I/0 count (10) 

° Task local event flags 

© Task registers and processor status word (memory-resident 

tasks only) 

Format: 


TAL [taskname] 


Example: 


. LDR. 052220 LDR 052164 00000000-00000000 PRI - 248. DPRI - 248. 
STATUS: -CHK FXD STP PRV 
TI =~ COO: IOC - 0. EFLG - 000001 000000 PS - 170000 PC - 041350 
REGS 0-6 000162 004030 177777 105312 064254 105260 052132 

TKTN 105010 SYSPAR 107734 00110000-00120000 PIR - 248. DPRI - 248. 
STATUS: -EXE OUT -CHK -PMD PRV 
TI - COO: IOC - 0. EFLG - 000001 000000 


ETC. 


ACTIVE TASK LIST 

This command displays on the entering terminal the names, 
descriptions, and status of all active tasks in the system or the 
status of a specified active task (taskname). The display is the same 
as the Task List command. 


Format: 


ATL [taskname] 
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F.7 A USEFUL TOOL 


RMDEMO is a privileged task that displays in a highly visual and 
active manner information concerning task activity in an RSX-11M 
system. The display usually runs continuously on a video terminal 
with cursor control (the VTO5B or the VT52). Certain versions of the 
task allow a once-only display on any record-oriented device. 


The display features include: 
1. Current date and time; 
2. The currently active task; 


3. All tasks, loaded drivers, and common blocks that are 
currently in memory, displayed in a graphic fashion to show 
their individual memory requirements and location relative to 
other tasks; 


4, The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by eacn group; 


5. The current amount of available system dynamic memory (POOL 
space), including the largest available block and the number 
of fragments; . 


6. A graphical display of the partition information; 


7. The number of hours that have elapsed since RMDEMO was 
initiated (this is system up time if the STARTUP_CMD file 
automatically runs RMDEMO when your system comes up). 


8. The number of free blocks available on the system device and 
one or more additional mounted FILES-11 volumes; 


9. The system error sequence count. 


RMDEMO scales the display to the memory size of the computer on which 
it is executing. The amount of memory displayed on the screen is 
always the next largest power of 2 in K-words. For a 28K system, it 
displays 32K. For a 256K system, 256K is displayed and the available 
memory just fills the screen. 


You should consider task locations and sizes that RMDEMO displays to 
be approximate only. RMDEMO provides a visual display and is a system 
debugging tool; however, it should not be used _ for accurate 
measurement of task size and location. 


A complete description of RMDEMO can be found in the RSX-11M_ System 
Generation Manual. 
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File primitive codes C-118, 
C-116 . 
File system 1-6 
Files-11 header offsets, macro 
definitions C-76 
Files-11 system 1-6 
FILIOS macro C-116 
FINITS/FSRSZS macros C-90 
Fixed tasks 1-11 
Fixing a checkpointable task 
1-11 
Fixing a task in memory 1-11 
Fixing an active task 1-11 
Flags, event 1-24 
Flow diagrams, memory allocation 
2-24 
SFNDSP, diagram 2-35 
routine 2-22 
Fork processing 3-13 
Fork queue 8-17 
SFORK routine 3-13 
SFORK, calling 3-13 
using 3-15 
SFORK1, USING 3-15 
Formatting standards for coding 
B-9 
Formatting the module preface, 
rules for B-6 
Free block list 8-6 
S$FRKHD pointer 8-6 
FSROF$ macro C-90 
Function codes for specific 
device dependent functions 
C-121 
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General purpose registers B-2 


Index-6 


INDEX (Cont.) 


Generation, system 1-1 
Get Command Line Control Block 
8-38 
Get Terminal support, bits for 
return from C-131 
GETS macro C-91 
GETSR macro C-91 
GETSS macro C-91 
Global cross-reference, BIGFCP 
9-54 
Executive 9-18 
MCRMU 9-30 
SYS 9-42 
Global symbols B-3 
GLUNS macro C28 
GLUNSC macro C-27 
GLUNSS macro C-27 
GMCR$ macro C-29 
GMCRSC macro C-29 
GMCXS macro C-105 
GMCX$C macro C-105 
GMCX$S macro C-105 
GPRTS macro C~-31 
GPRTSC macro C-30 
GPRTSS macro C-30 
GREGSC macro C~105 
GREGSS macro C-105 
GREGS macro C-105 
GSSWSS macro C-32 
GSSWSC macro C-32 
GSSWS macro C-32 
GTIMS macro C-34 
GTIMSC macro C-33 
GTIMSS macro C-33 
GTSKS macro C-35 
GTSKS$SS macro C-35 
GTSKSC macro C-34 
GTUCB$ macro C-72 


H 


Hardware definitions 8-39 

Hardware register addresses 8-39 
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8-39 

SHEADR pointer 8-7 
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I/O control block linkage 8-26 
I/O data structure 8-27 
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I/O functions IP11 C-123 


I/O implementation 6-1 
I/O Packet queue 8-21 
I/O Packet offset definitions 
8-30 
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SICHKP diagram 2-36 
ICR error codes C-119 
ICR QIO functions C-122 
IcS error codes C-119 
ICS QIO functions C-122 
IHARS macro C-37 
IHARSC macro C-37 
IHARSS macro C-37 
/INDX option, for tuning F-3 
INITL module description 7-49 
Install command 1-3 
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exit support for tuning F-2 
Installed priority 1-12 
Installed priority, establish- 
ing, with Install 1-12 
Installed task, STD entry 1-10 
Installed tasks 1-10 
Instruction usage, forbidden 
B-11 
Interface, MCR 1-25 
Interrupt conventions, for 
drivers 3-13 
Interrupt locations 1-18 
Interrupt mechanism, for RSX- 
11M 3-1 
hardware 3-1 
Interrupt processing 1-2, 1-15, 
3-1 
Interrupt processing code 3-17 
Interrupt processing routines, 
DIRSV 3-3 
DIRXT 3-3 
INTSV 3-2 
INTXT 3-3 
for drivers 3-3 
Interrupt routine, driver, 
example of 3-15 
Interrupt routines, processing 
within 3-12 
Interrupt Transfer Block 8-40 
Interrupt vectors 1-16 
Interrupts, classes of 3-1 
device 3-2 
Executive processing 3-2 
external 1-17 
external 3-2 
external, from system state 
3-5 
from task state 3-4 
flow of control in 3-18 
loadable drivers 3-3 
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queued on the sytem stack 3-12 
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stack processing 3-2 
Interrupt processes 3-2 
INTLB macro C=-72 
Intra-module calling conventions 
B-8 
INTSES macro C-73 
SINTSV routine 3-2 
SINTSV routine operation 3-5 
INTSVS macro 3-3 
INTSV$ macro 3-5 
INTSVS macro C-73 
INTSVS$ macro expansion 3-6 
INTSVS macro format 3-4 
INTSV$ macro, example of a 
driver using 3-6 
used in a driver 3-13 
SINTSV, calling from driver 3-12 
SINTXT routine 3-3 
SINTXT routine processing 3-16 
-IOER macro C-117 
IOERRS macro 117 
IOSUB module description 7-50 
IP11 I/O functions C-123 
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Keyword table generation macros 
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KT11 hardware 1-15 

KT11 memory management unit 1-3 
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Label block offsets 8-51 
LCB list 8-19 
LCB, DCB, SCB, UCB relationship 
8-18 
LDD macro C-76 
LDFPS macro C-76 
LDROS macro C-4 
SLDRPT pointer 8-6 
Library list entry flags 8--50 
Line format B-1 
Linkage, for I/O control blocks 
8-26 
Linkages, system 8-1 
Linked lists on RSX-11M 8-2 
List, ATL 8-11 
LCB 8-19 
PCB 8-10 


STD 8-11 

Loadable device drivers for 
tuning F-2 

Loaded task 1-11 

Loader 1-5, 2-15 

Loader diagram 2-43 

Loader functions 2-15 

Loader queue 8-15 

Loader, defined 1-5 

VMR installable, for tuning 

F-3 

LOADR module description 7-62 

Locked task 1-11 

Logical address space 1-14, 1-15 

Logical addresses 2-3 

Logical addresses space 2-3 

Logical addressing 2-2 

Logical assignment control block 
8-41 

Logical assignment control block 
list 8-19 

LOWCR module description 7-62 

/LRU option, for tuning F-3 
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Macro definitions, files-11 
header offsets C-76 
Macro expansions C-1 
Macro expansions (see the 
specific macro name) 
Macro expansions, directive C-5 
Executive C-71 
file control services C~-79 
QIOMAC C-115 
QIOSYM C-115 
relative file C-110 
Macro names B-4 
Main partition 1-4 
Management, resource, memory 1-2 
MAPS macro C-106 
MAPSC macro C-106 
MAPSS macro C-106 
Mapped system, example of 1-8 
Mapping 1-3 
Mapping assignment block 8-46 
Mapping, 4k nonprivileged user 
task, in mapped system 4-12 
8k nonprivileged user task, 
in mapped system 4-13 
defined 1-3 
in a mapped system 1-3 
in an unmapped system 1-3 
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user task in unmapped system Module to conditional assembly 
4-11 parameter cross-reference 
MCR 1-7 9-75 
MCR and terminal driver rela- Module to routine cross- 
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MCR commands 5-1 9-1 
MCR dispatcher 5-5 Executive, 
MCR interface 1-25 CORAL 9-1 
MCR interface 5-1 CRASH 9-1 
MCR operation 5-5 CTDRV 9-1 
MCR queue 8-20 CVRTM 9-2 
MCR task 1-5 DBDRV 9-2 
MCR, buffer processing 5-6 DLDRV 9-2 
command overlay 5-7 DMDRV 9-2 
common overlay 5-7 DPDRV 9-2 
dispatcher 5-8 DRABO 9-2 
error overlay 5-10 DRASG 9-2 
explained 5-1 DRATX 9-2 
final exit 5-10 DRCIN 9-3 
function tables 5-7 -DRCMT 9-3 
input queue entry 5-6 DRDAR 9-3 
operating environment of 5-2 DRDCP 9-3 
overlays 5-7 DRDSP 9-3 
parser functions 5-9 DREIF 9-3 
parser overlay 5-7 DREXP 9-3 
parser table entry 5-8 DRGCL 9-3 
structure of 5-2 DRGLI 9-3 
MCRMU 1-9 DRGPP 9-3 
MCRMU global cross-reference DRGSS 9-3 
9~30 DRGTP 9-4 
MCRMU, segment cross-reference DRGTX 9-3 
9-41 DRMAP 9-4 
Memory 1-2 DRMKT 9-4 
Memory addressing 2-1 DRPUT 9-4 
Memory allocation 2-10 DRQIO 9-4 
Memory allocation data structures DRRAS 9-5 
2-61 DRREG 9-5 
Memory compaction 2-13 DRREQ 9-5 
Memory management directives 2-2 DRRES 9-5 
Memory management for tuning F-2 DRSED 9-6 
Memory management overview 2-1 DRSST 9-6 
Memory management register DTDRV 9-6 
addresses 8-39 DXDRV 9-6 
Memory management register status ERROR 9-6 
codes 8-39 INITL 9-7 
Memory management directives 1-15 IOSUB 9-7 
Memory management unit 1-3 LOADR 9-8 
Memory partitions 1-2 LOWCR 9-8 
Memory resource allocation 2- i. LPDRV 9-8 
Memory resource management 1-2 MMDRV 9-9 
Memory structure 1-4 MTDRV 9-9 
MFPS/MTPS macros C-74 NLDRV 9-9 
Modularity B-8 PARTY 9-9 
Module preface B-5 PLSUB 9-10 
Module preface, formatting the POWER 9-10 
B-6 PPTAB 9-10 
PRDRV 9-10 
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QUEUE 9-10 
REQSB 9-10 
SSTSR 9-11 
SYSCM 9-11 
SYSDF 9-12 
SYSTB 9-12 
SYSXT 9-12 
SYTAB 9-13 
TDSCH 9-13 
TTDRV 9-13 
XBDRV 9-14 
XMDRV 9-15 
XPDRV 9-16 
XODRV 9-16 
XUDRV 9-16 
XWDRV 9-17 
MOVS macro C-38 
MRKTS macro C-39 
MRKTSC macro C-38 
MRKTSS macro C-39 
MTRANS macro C~-126 
Multiuser protection 1-27 
MVBS macro C-40 
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Naming B-2 
NBOFSL macro C-91 
NBOFFS macro C-92 
Network ACP codes C-119 
Network symbol definition macros 
c-100 
NMBLKS$ macro C-92 
Nonprivileged tasks, in a mapped 
system 1-3 
SNXTSK diagram 2-37 
SNXTSK routine 2-13 
SNXTSK, functions 2-17 
inputs 2-17 
operation in a system- 
controlled partition 2-18 
operation in a user-controlled 
partition 2-17 
routine 2-17 
routines that call 2-18 
routines that call, description 
of 2-20 
routines that it calls 2-22 
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OFFS macro C-40 
OFIDS macro C-95 
OFIDSA macro C-95 


OFIDSM macro C-96 
OFIDSR macro C-96 
OFIDSU macro C-96 
OFIDSW macro C-96 
OFNBS$ macro C-96 
OFNBSA macro C-97 
OFNBSM macro C-97 
OFNBSR macro C-97 
OFNBSU macro C-97 
OFNBSW macro C-97 
OPENS macro C-93 
OPENSA macro C-93 
OPENSM macro C-93 
OPENSR macro C-93 
OPENSU macro C-94 
OPENSW macro C-94 
Operation of a terminal 1-26 
OPNSSA macro C-94 
OPNSSM macro C-94 
OPNSSR macro C-94 
OPNSSU macro C-94 
OPNSSW macro C-95 
OPNTSD macro C-95 
OPNTSW macro C-95 
Overlaid task addressing 2-1 
Overlaid tasks 1-14 
Overlays 1-14 
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PAR command for tuning F-6 
SPARHD pointer 8-5 
Partition control block 1-10, 
2-61, 8-5, 8-10, 8-41 
Partition status word bit 
definitions 8-42 
Partition types 1-3 
Partition wait queue, example of 
8-9 
Partitions 1-1 
Partitions, defined 1-2 
in mapped systems 1-3 
in unmapped system 1-3 
memory 1-2 
system-controlled 1-4 
task, user 1-7 
user-controlled 1-4 
PARTY module description 7-63 
Passing arguments B-8 
PCB (see partition control block) 
PCB list for checkpoint files 
8-10 
Physical address space 1-15 
Physical addresses 1-3, 2-3 
Physical addresses, range of 1-3 
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PLAS macro definitions C-101 
PLSUB module description 7-64 
Pointers, ACTHD 8-5 


CRAVL 8-6 
DEVHD 8-4 
FRKHD 8-6 
HEADR 8-7 
LDRPT 8-6 
PARHD 8-5 
RQSCH 8-6 
TKNPT 8-6 
TKTCB 8-6 
TSKHD 8-5 
system 8-1 


Power failure restart 1-29 
POWER module description 7-66 
Powerfail processing 3-11 
Pre-allocated I/O packet queue 
8-21 
Print spooler 1-7 
Print spooler, macro for 
submitting a file to C-128 
PRINTS macro C-128 
Priority l-11l 
Priority, altering 1-12 
swapping 1-14 
tasks with equal 1-12 
Private devices 1-27 
Privileged commands 1-25 
Privileged task execution, 
logging off during 4-1 
processor trap during 4-1 
Privileged task hazards 4-1 
Privileged task mapping 4-2, 4-3, 
4-4, 4-10, 4-15 
Privileged task, /PR:0 switch 
4-2 
/PR:4 switch 4-2 
/PR:5 switch 4-4 
reading or writing to a volume 
4-1 
specifying a task as a 4-2 
using commons 4-2 
Privileged tasks 4-1 
Privileged tasks, accessing the 
I/O page 4-2 
in a mapped system 1-3 
rebuilding, in a mapped system 
1-3 
using SWSTKS 4-5 
writing 4-4 
writing logical block I/0 4-2 
Processing within interrupt 
routines 3-12 
Processing, interrupt 1-2 
task 1-2 


Processor control, assigned by 
priority 1-i1 

Processor priority B-2 

Processor trap 1-17 

Processor trap during privileged 
task execution 4-1 

Processor trap, from the system 
state 3-9 

Processor traps 1-15, 3-1 

Processor traps, from task state 
3-7 

Program logical address space 
extension, macro definitions 
C-101 

Program modules B-5 

Program-local sysmbols B-4 

Protection, multiuser 1-27 

region 2-9 

Pseudo device DCBs 8-4 

Public devices 1-27 

PUTS macro C-97 

PUTSR macro C-98 

PUTSS macro C-98 
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QDPBS$ macro C-41 
QDPBSS macro C-41 
QIO directive provessing 6-5 
QIO function codes for specific 
device dependent functions 
C-121 
QIO functions, ICR C-122 
ICS CH122 
QIO processing 6-1 
QIO qualifier bit definitions, 
general C-116 
QIOS macro C-43 
QIOSC macro C-42 
QIOS$S macro C-42 
-QIOE macro C-120 
QIOMAC macro definitions C-115 
QIOSY$ macro C-120 
QIOSYM macro definitions C-115 
QIOWS macro C-44 
QIOWSC macro C-43 
QIOWSS macro C-44 
Queue I/O speed optimizations for 
tuning F-2 
QUEUE module description 7-67 
Queue, AST 8-14 
clock 8-16 
dynamic storage region free 
block 8-23 
fork 8-17 
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I/O packet 8-21 RFOFFS macro C-111 

Loader 8-15 RGETS macro C-112 

MCR 8-20 RMDEMO, for tuning F-5, F=8 
Send/Receive by Reference 8-16 RMS (see record management 
Send/Receive Data 8-15 services) 

STD, in scheduling 1-12 ROPNS macro C-112 

TKTN 8-22 ROPNSR macro C-113 


ROPNSA macro C~-112 
ROPNSM macro C-112 


R ROPNSU macro C-113 
ROPNSW macro C-113 

R50$ macro C-45 ROPSSR macro C-113 
RREFSC macro C-107 ROPSSA macro C-113 
RREFSS macro C-107 ROPSSM macro C-113 
RAD$50$S macro C-98 ROPSSU macro C-114 
RCLOS$ macro C-110 ROPSSW macro C-114 
RCVDS$ macro C-46 Round-robin scheduling 1-12 
RCVDSC macro C-45 Round-robin scheduling for 
RCVDSS macro C-46 tuning F-2 
RCVX$ macro C-48 Round-robin scheduling, use of 
RCVX$SC macro C-47 STD 1-12 


RCVXSS macro C-47 
RDAFS macro C-49 
RDAFSC macro C-48 


RPORTS macro C-114 
RPRTCS macro C-114 
RPUTS macro C-114 


RDAF$S macro C-49 SROSCH pointer 3-17 
RDBBK$ macro C-107 SROQSCH pointer 8-6 
READS macro C-99 ROSTS macro C-51 
Ready-to-run tasks 1-10 ROSTSS macro C-51 
Rebuilding privileged tasks in ROSTSC macro C-50 
a mapped system 1-3 RREFS macro C~-107 

Record management services 1-6 RSUMS macro C-53 
Region definition block 2-10 RSUM$SS macro C-52 
Region definition block 8-43 RSUMSC macro C-52. 
Region protection 2-9 RSX-11M supported devices a~-1 
Region status word symbols 8-43 RSX-11M system 1-1 
Region, creating a 1-15 RUN$ macro C-54 

dynamic 2-8 RUNSC macro C-53 

mapping to 1-15 RUNSS macro C-54 

static common 2-8 RVP$ macro C-55 

task 2-8 
Regions 2-8 
Regions, attaching to 2-9 S 

shared 2-9 
Register standards B-2 Save command 1-2 
Registers B-2 SAVNR macro C-74 
Relative file macro C-110 SCB, DCB, UCB, LCB relationship 
REQSB module description 7-69 8-18 
Resident library descriptor SCB, UCB, DCB relationship 8-24 

offsets 8-50 SCBLB macro C-74 

Resident tasks 1-10 Scheduling 1-2, 1-12 
Resource management, memory 1-2 SSCNDT routine 8-4 
Restart, power failure 1-29 SDATS macro C-57 
RETURN macro C-74 SDATSS macro C-56 
RFAS macro C-50 SDATSC macro C-56 
RFDBTS macro C-110 Segment cross-reference, BIGFCP 
RFIND$ macro C-111 9-69 
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MCRMU 9~41 
SYS 9-54 
Send/Receive by Reference queue 
8-16 
Send/Receive Data queue 8-15 
Servicing faults E-1 
Set characteristic error codes 
C-130 


Set characteristics, speed types 


C-130 
subfunction codes for C-130 
terminal types C-130 
SET/GET symbol macro expansions 
c-129 
SETD macro C-75 
SETFS macro C-58 
SETFSS macro C-58 
SETFSC macro C-57 
SFPAS macro C-59 
SFPASS macro C-59 
SFPASC macro C-59 
Shared regions 2-9 
Shuffler 1-4, 1-9, 2-13 
Shuffler diagram 2-51 
Shuffler task 1-14 
Shuffler, algorithm of 2-14 
basic operation of 1-14 
first pass of 2-14 
second pass of 2-14 
Shuffling, for tuning F-2 
Size of dynamic storage region, 
for tuning F-2 
Slave terminals 1-27 
Snap block 8-46 
Snap control block macro C-124 
SNAPS macro C-124 
Snapshot sump macro C-124 
SNPBK$ macro C-124 
SNPDF$ macro C-125 
SOB macro C-75 
Source files B-11 
SPCIOS macro C-121 
Speed types, for set character- 
istics C-130 
SPNDS macro C-61 
SPNDSS macro C-60 
SPNDSC macro C-60 
Spooler, print 1-7 
SPRAS macro C~-62 
SPRASS macro C-61 
SPRASC macro C-61 
SRRASS macro C-109 
SRRASC macro C-109 
SRDAS macro C=-63 
SRDASS macro C-63 
SRDASC macro C-62 


SREFS macro C-107 8 
SREFSS macro C-108 
SREFSC macro C-108 
SRRAS macro C-109 
SSTSR module description 7-77 
Stack structure, fault tracing 
E-8 
Stack, system 1-16 
system, queuing interrupts on 
3-12 
upon entry into directive 
processing 3-10 
Standard codes, driver C-117 
executive C-117 
Standard symbols, using the B-3 
Standards and conventions, 
coding B-1 
State generation macros C-125 
STATES macro C-126 
Static common region 2-8 
Status control block 6-1, 6-2, 
8-5, 8-44 
Status return, directive 
processing routines 3-11 
STD (see system task directory) 
STD list 8-11 
STD macro C-75 
STFPS macro C-75 
SSTKDP<=0 3-5 
SSTKDP=1 3-4, 3-7 
STST macro C-75 
Subfunction codes for the set 
characteristics C-130 
Subpartitions 1-4, 1-7 
Success codes, TTY C-119 
Supported devices, card readers 
A-2 
communications A-2 
data acquisition A-2 
disk devices A-3 
laborator/industrial control 
A-3 
printers A-4 
processors and options A-1 
RSX-11M A-1 
tape devices, magnetic A-4 
paper A-5 
terminals A-5 
SVDB$ macro C-65 
SVDBSS macro C-64 
SVDBSC macro C-64 
SVTKS macro C-66 
SVTKSS macro C-66 
SVTKSC macro C-65 
Swapping algorithm 2-12 
Swapping for tuning F-2 
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Swapping interval 2-12 

Swapping priority 1-14 

Swapping priority range 2-12 

Swapping tasks 1-13 

Swapping, disk 2-12 

SWSTKS in a mapped system, 
explained 4-5 

SWSTKS macro C-76 

SWSTKS routine, described for a 
mapped system 4-5 

described for an unmapped 

system 4-8 

SWSTKS, used by privileged tasks 
4-5 

Symbols B-2 

Synchronous events 1-2 

Synchronous traps 1-18 

SYS global cross-reference 9-42 

SYS segment cross-reference 9-54 

SYSCM module description 7-80 

SYSDF module description 7-82 

SYSPAR 1-7 

SYSPAR partition 1-9 

SYSTB 8-4 

SYSTB module description 7-83 

System common data 1-4 

System controlled partitions 1-4 

System generation 1-1 

System generation, phase one I1-1 

phase two 1-1 

System linkages 8-1 

System linkages 8-7 

System maintenance 1-27 

System pointers 8-1 

System stack 1-4, 1-16 

System stack, queuing interrupts 
on 3-12 

System state, exiting 3-15 

System task directory 1-10 

System task directory list 8-11 

System traps 1-18 

System tuning F-1 

System, RSX-11M 1-1 

System-controlled partition 
control blocks 8-13 

System-controlled partition 
linkage 8-5 
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TAL command for tuning F-7 

TAS command for tuning F-5 

Task abort codes 8-47 

Task attributes, changing 1-3 

Task control block 2-65, 8-5, 
8-47 


Task execution, scheduling of 
1-26 
Task header, field definitions 
8-49 
mapped system E-5 
unmapped system E-5 
window block 8-49 
Task mapping 4-10 
Task mapping, 4k nonpriviliged 
user, in mapped system 4-12 
8k nonprivileged user, in 
in mapped system 4-13 
in mapped system using PLAS 
4-14 
nonprivileged user, in mapped 
system 4-12 
user, in unmapped system 4-11 
Task partitions, user 1-7 
Task priority 1-11 
Task priority, assigning 1-11 
establishing 1-12 
Task processinc 1-10, 1-2 
Task region 2-8 
Task scheduling 1-2 
Task states 1-10 
Task status definitions 8-48 
Task swapping 1-13 
Task termination notification 
message codes 8-51 
Task termination notification 
queue 8-22 
Task window block 2-7 
Task windows 2-4 
Task, shuffler 1-14 
Tasks, active 1-10 
blocked 1-10 
diagnostic 1-28 
dormant 1-10 
fixed 1-11 
installed 1-10 
overlaid 1-14 
privileged 4-1 
privileged, PR:0 switch 4-2 
PR:4 switch 4-2 
PR:5 switch 4-3 
accessing the I/O page 4-2 
hazards of using 4-1 
mapping of 4-15 
specifying 4-2 
using commons 4-2 
virtual address space 4-3, 
4-4 
writing a 4-4 
writing logical block I/0 
4-2 
ready-to-run 1-10 
unshufflable 2-13 
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with equal priorities 1-12 
Task image file label block 8-50 
STCHKP routine 2-22 
TDSCH module description 7-89 
Terminal input wait, checkpoint- 

ing during 2-11 
Terminal operation 1-26 
Terminal types, for SET charac- 
teristics C-130 
Terminals, attached 1-26 

Slave 1-27 
Throughput improvement F-1 
Throughput improvement, execu- 

tive software opinions for 
Fl 

memory layout for F-1 
STKNPT pointer 8-6 
STKTCB pointer 8-6 
TKIN 1-7 
TKTN queue 8-22 
TKTN task 1-5 
Tracing faults E-4 
TRANS macro C-127 
Trap processing, for traps in 

system state 3-9 
Trap vectors 1-4 
Trap vectors 3-1 
Trap, processor 1-17 
Traps, asynchronous 1-18 

processor 3-1 

synchronous 1-18 

system 1-18 
TRUNCS macro C-99 
STSKHD pointer 8-5 
TSTATS macro C-125 
STSTCP diagram 2-42 
STSTCP routine 2-23 
TTSYMS macro C-129 
TTY error codes C-119 
TTY success codes C-119 
Tuning, Executive software 

options for F-1 

hardware considerations F-1 

helpful hints F-4 

memory layout F-1 


system F-1 
UCB 8-51 
UCB, DCB, SCB, LCB relationship 
8-18 


UCB, SCB, DCB relationship 8-24 
UCB-DCB relationship 8-4 
UMAP$ macro C-109 


UMAPSC macro C-109 

UMAPSS macro C-109 

UMDIOS macro. C-123 

Unit Control Block 6-1, 6-2, 
8-4, 8-51 

Unmapped system, example of 1-7 

Unshufflable tasks 2-13 

User: controlled partitions 1-4 

User-controlled partition, 
control blocks 8-12 

linkage 8-5 

User-mode diagnostic functions 

C-123 
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Vector locations 1-18 

Vectors, interrupt 1-16 

Version identifier, displaying 
the B-13 

Version number standard B-12 

Version number, use of in the 
program B-14 

Virtual address mapping 2-6 

Virtual address space 1-15, 2- 

Virtual addresses 1-3, 2-2, 2- 

VMR installable loader, for 
tuning F-2 

Volume control block 8-56 


W 


WAITS macro C-99 
WDBBKS macro C-110 
/WIN option, for tuning F-3 
Window block, task 2-7 
Window definition block 8-56 
Window Definition Block 2-7 
Window status word symbols 8-57 
Windows, memory management 

directives 2-4 

task 2-4 

.WORD macro C-124 
WRITES macro C-99 
Writing a privileged task 4-4 
WSIGS macro C-67 
WSIGSS macro C-67 
WSIGSC macro C-67 
WILOS macro C-69 
WILOSC macro C-68 
WTLOSS macro C-68 
WISES macro C-70 
WTSESS macro C-70 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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